OID_WDI_ABORT_TASK (dot11wificxintf.h)

  • Artikel

Wichtig

Dieses Thema ist Teil des WiFiCx-Treibermodells. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen. Das vorherige Wi-Fi Treibermodell WDI befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.

OID_WDI_ABORT_TASK ist eine Eigenschaft, die nach unten gesendet wird, um eine bestimmte ausstehende Aufgabe abzubrechen.

`Scope` Set serialisiert mit Task Normale Ausführungszeit (Sekunden)
Port Nein 1

Dieser Befehl folgt der Eigenschaftensemantik. Es sollte als Signal behandelt, so schnell wie möglich behandelt und unabhängig von der Aufgabenerledigung abgeschlossen werden. Die IHV-Komponente muss dann versuchen, die ausstehende Aufgabe so bald wie möglich abzuschließen.

Befehlsparameter

TLV Mehrere zulässige TLV-Instanzen Optional BESCHREIBUNG
WDI_TLV_CANCEL_PARAMETERS Informationen für den Befehl, der abgebrochen wird.

Befehlsergebnis

Enthält eine status von NDIS_STATUS_SUCCESS. Es gibt keine zusätzliche Nutzlast.

Beispiele

Ursprünglicher Eingabetaskbefehl:

Feld Unterfeld Typ Wert
NDIS_OID_REQUEST OID NDIS_OID OID(WDI_TASK_SCAN)
--- InputBufferLength UINT32 0x210 (Beispiel)
--- InformationBuffer PVOID Zeiger auf den Speicherblock mit WDI_MESSAGE_HEADER + TLV-Nutzlast
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (Beispiel)
--- Reserviert UINT16 –
--- WiFiStatus NDIS_STATUS –
--- TransactionId UINT32 0x1111 (Beispiel)
--- IhvSpecificId UINT32 –
TLV-Nutzlast TLV-Nutzlast Verschiedene Nutzlastdaten

Befehl "Taskeingabe abbrechen" (mit Nachrichtenheader):

Feld Unterfeld Typ Wert
NDIS_OID_REQUEST OID NDIS_OID OID(WDI_ABORT_TASK)
--- InputBufferLength UINT32 sizeof(WDI_MESSAGE_HEADER) + sizeof(WDI_TLV_CANCEL_PARAMETERS)
--- InformationBuffer PVOID Zeiger auf den Speicherblock mit WDI_MESSAGE_HEADER + TLV-Nutzlast
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (Beispiel)
--- Reserviert UINT16 –
--- WiFiStatus NDIS_STATUS –
--- TransactionId UINT32 0x2222 (Beispiel)
--- IhvSpecificId UINT32 0
WDI_TLV_CANCEL_PARAMETERS OriginalTaskOid NDIS_OID OID(WDI_TASK_SCAN)
--- OriginalPortId UINT16 0x0001 (Beispiel)
--- OriginalTransactionId UINT32 0x1111 (Beispiel)

Ergebnis des Befehls "Task abbrechen":

Feld Unterfeld Typ Wert
NDIS_OID_REQUEST OID NDIS_OID OID(WDI_TASK_SCAN)
--- OutputBufferLength UINT32 sizeof(WDI_MESSAGE_HEADER)
--- InformationBuffer PVOID Zeiger auf einen Speicherblock mit WDI_MESSAGE_HEADER
WDI_MESSAGE_HEADER PortId UINT16 0x0001 (Beispiel)
--- Reserviert UINT16 –
--- WiFiStatus NDIS_STATUS NDIS_STATUS_SUCCESS
--- TransactionId UINT32 0x2222 (Beispiel)
--- IhvSpecificId UINT32 –

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11
Unterstützte Mindestversion (Server) Windows Server 2022
Header dot11wificxintf.h