Freigeben über


EVT_WIFI_DEVICE_SEND_COMMAND Rückruffunktion (wificx.h)

Die Rückruffunktion EvtWifiDeviceSendCommand eines WiFiCx-Treibers ruft eine vom WiFiCx-Framework gesendete Befehlsnachricht ab und verarbeitet sie.

Syntax

EVT_WIFI_DEVICE_SEND_COMMAND EvtWifiDeviceSendCommand;

void EvtWifiDeviceSendCommand(
  WDFDEVICE Device,
  WIFIREQUEST SendRequest
)
{...}

Parameter

Device

[In] Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber von einem vorherigen Aufruf von WdfDeviceCreate abgerufen hat.

SendRequest

[In] Ein Handle für ein FRAMEWORK-WIFIREQUEST-Objekt, das eine Befehlsnachricht darstellt.

Rückgabewert

Keine

Bemerkungen

Ein WiFiCx-Clienttreiber muss seine EvtWifiDeviceSendCommand-Rückruffunktion registrieren, indem er WiFiDeviceInitialize aufruft.

Das WiFiCx-Framework ruft EvtWifiDeviceSendCommand auf, um eine Befehlsnachricht an den Clienttreiber auszugeben.

  • Um die Nachricht abzurufen, ruft der Clienttreiber WifiRequestGetInOutBuffer auf, um die Eingabe-/Ausgabepuffer- und Pufferlängen abzurufen. Der Treiber muss auch WifiRequestGetMessageId aufrufen, um die Nachrichten-ID abzurufen.

  • Um die Anforderung abzuschließen, sendet der Treiber den M3 für den Befehl asynchron, indem er WifiRequestComplete aufruft.

  • Wenn es sich bei diesem Befehl um einen set-Befehl handelt und die ursprüngliche Anforderung keinen ausreichend großen Puffer enthielt, sollte der Client WifiRequestSetBytesNeed aufrufen, um die erforderliche Puffergröße festzulegen, und die Anforderung dann mit status BUFFER_OVERFLOW.

  • Wenn es sich bei diesem Befehl um einen Taskbefehl handelt, muss der Clienttreiber später die zugehörige M4-Anzeige senden, indem er WifiDeviceReceiveIndication aufruft und den Anzeigepuffer mit einem WDI-Header übergeben, der dieselbe Nachrichten-ID wie im M1 enthält.

Weitere Informationen finden Sie unter Behandeln von WiFiCx-Befehlsmeldungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11
Unterstützte Mindestversion (Server) Windows Server 2022
Kopfzeile wificx.h
IRQL <= DISPATCH_LEVEL

Weitere Informationen

Behandeln von WiFiCx-Befehlsmeldungen

WiFiDeviceInitialize

WifiRequestGetInOutBuffer

WifiRequestGetMessageId

WifiRequestComplete