EVT_WIFI_DEVICE_SEND_COMMAND Rückruffunktion (wificx.h)

Artikel
07.02.2025

Die EvtWifiDeviceSendCommand Rückruffunktion 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 aus einem vorherigen Aufruf von WdfDeviceCreateabgerufen hat.

SendRequest

[In] Ein Handle zu einem Framework WIFIREQUEST-Objekt, das eine Befehlsmeldung darstellt.

Rückgabewert

Nichts

Bemerkungen

Ein WIFiCx-Clienttreiber muss seine EvtWifiDeviceSendCommand Rückruffunktion registrieren, indem WiFiDeviceInitializeaufgerufen wird.

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

Um die Nachricht abzurufen, ruft der Clienttreiber WifiRequestGetInOutBuffer auf, um den 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 WifiRequestCompleteaufgerufen wird.
Wenn dieser Befehl ein Satzbefehl ist und die ursprüngliche Anforderung keinen großen Puffer enthält, sollte der Client WifiRequestSetBytesNeededed aufrufen, um die erforderliche Puffergröße festzulegen, und dann schlägt die Anforderung mit dem Status BUFFER_OVERFLOW fehl.
Wenn dieser Befehl ein Aufgabenbefehl ist, muss der Clienttreiber später die zugeordnete M4-Anzeige senden, indem WifiDeviceReceiveIndication aufgerufen und der Anzeigepuffer mit einem WDI-Header übergeben wird, der dieselbe Nachrichten-ID enthält wie in der M1 enthalten.