Edit

Share via

OID_WDI_ABORT_TASK

  • Article

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

OID_WDI_ABORT_TASK is a property that is sent down to cancel a specific pending task.

Scope Set serialized with task Normal execution time (seconds)
Port No 1

This command follows property semantics. It should be treated as a signal, should be handled as quickly as possible, and should be completed independently of task completion. The IHV component must then attempt to complete the pending task as soon as possible.

Command parameters

TLV Multiple TLV instances allowed Optional Description
WDI_TLV_CANCEL_PARAMETERS Information for the command that is being cancelled.

Command result

Contains a status of NDIS_STATUS_SUCCESS. There is no additional payload.

Examples

Original input task command:

Field Subfield Type Value
NDIS_OID_REQUEST Oid NDIS_OID OID(WDI_TASK_SCAN)
--- InputBufferLength UINT32 0x210 (example)
--- InformationBuffer PVOID Pointer to memory block containing WDI_MESSAGE_HEADER + TLV payload
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (example)
--- Reserved UINT16 N/A
--- WiFiStatus NDIS_STATUS N/A
--- TransactionId UINT32 0x1111 (example)
--- IhvSpecificId UINT32 N/A
TLV Payload TLV Payload Various Payload data

Abort task input command (with message header):

Field Subfield Type Value
NDIS_OID_REQUEST Oid NDIS_OID OID(WDI_ABORT_TASK)
--- InputBufferLength UINT32 sizeof(WDI_MESSAGE_HEADER) + sizeof(WDI_TLV_CANCEL_PARAMETERS)
--- InformationBuffer PVOID Pointer to memory block containing WDI_MESSAGE_HEADER + TLV payload
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (example)
--- Reserved UINT16 N/A
--- WiFiStatus NDIS_STATUS N/A
--- TransactionId UINT32 0x2222 (example)
--- IhvSpecificId UINT32 0
WDI_TLV_CANCEL_PARAMETERS OriginalTaskOid NDIS_OID OID(WDI_TASK_SCAN)
--- OriginalPortId UINT16 0x0001 (example)
--- OriginalTransactionId UINT32 0x1111 (example)

Abort task command result:

Field Subfield Type Value
NDIS_OID_REQUEST Oid NDIS_OID OID(WDI_TASK_SCAN)
--- OutputBufferLength UINT32 sizeof(WDI_MESSAGE_HEADER)
--- InformationBuffer PVOID Pointer to memory block containing WDI_MESSAGE_HEADER
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (example)
--- Reserved UINT16 N/A
--- WiFiStatus NDIS_STATUS NDIS_STATUS_SUCCESS
--- TransactionId UINT32 0x2222 (example)
--- IhvSpecificId UINT32 N/A

Requirements

Minimum supported client

Windows 10

Minimum supported server

Windows Server 2016

Header

 Dot11wdi.h