OID_WDI_ABORT_TASK (dot11wificxintf.h)
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 |