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 |