EVT_WIFI_DEVICE_SEND_COMMAND fonction de rappel (wificx.h)

La fonction de rappel EvtWifiDeviceSendCommand d’un pilote WiFiCx récupère et traite un message de commande envoyé par l’infrastructure WiFiCx.

Syntaxe

EVT_WIFI_DEVICE_SEND_COMMAND EvtWifiDeviceSendCommand;

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

Paramètres

Device

[In] Handle pour un objet d’appareil framework que le pilote client a obtenu à partir d’un appel précédent à WdfDeviceCreate.

SendRequest

[In] Handle d’un objet FRAMEWORK WIFIREQUEST qui représente un message de commande.

Valeur de retour

None

Remarques

Un pilote client WiFiCx doit inscrire sa fonction de rappel EvtWifiDeviceSendCommand en appelant WiFiDeviceInitialize.

Le framework WiFiCx appelle EvtWifiDeviceSendCommand pour émettre un message de commande au pilote client.

  • Pour récupérer le message, le pilote client appelle WifiRequestGetInOutBuffer pour obtenir la mémoire tampon d’entrée/sortie et les longueurs de mémoire tampon. Le pilote doit également appeler WifiRequestGetMessageId pour récupérer l’ID de message.

  • Pour terminer la demande, le pilote envoie le M3 pour la commande de manière asynchrone en appelant WifiRequestComplete.

  • Si cette commande est une commande set et que la demande d’origine ne contenait pas une mémoire tampon suffisamment grande, le client doit appeler WifiRequestSetBytesNeeded pour définir la taille de mémoire tampon requise, puis faire échouer la demande avec status BUFFER_OVERFLOW.

  • Si cette commande est une commande de tâche, le pilote client doit envoyer ultérieurement l’indication M4 associée en appelant WifiDeviceReceiveIndication et passer la mémoire tampon d’indication avec un en-tête WDI qui contient le même ID de message que celui contenu dans le M1.

Pour plus d’informations, consultez Gestion des messages de commande WiFiCx.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11
Serveur minimal pris en charge Windows Server 2022
En-tête wificx.h
IRQL <= DISPATCH_LEVEL

Voir aussi

Gestion des messages de commande WiFiCx

WiFiDeviceInitialize

WifiRequestGetInOutBuffer

WifiRequestGetMessageId

WifiRequestComplete