EVT_WIFI_DEVICE_SEND_COMMAND função de retorno de chamada (wificx.h)
Uma função de retorno de chamada do driver WiFiCx EvtWifiDeviceSendCommand recupera e processa uma mensagem de comando enviada pela estrutura WiFiCx.
Sintaxe
EVT_WIFI_DEVICE_SEND_COMMAND EvtWifiDeviceSendCommand;
void EvtWifiDeviceSendCommand(
WDFDEVICE Device,
WIFIREQUEST SendRequest
)
{...}
Parâmetros
Device
[em] Um identificador para um objeto de dispositivo de estrutura que o driver cliente obteve de uma chamada anterior para WdfDeviceCreate.
SendRequest
[em] Um identificador para um objeto WIFIREQUEST da estrutura que representa uma mensagem de comando.
Valor de retorno
Nenhum
Observações
Um driver cliente WiFiCx deve registrar sua função de retorno de chamada EvtWifiDeviceSendCommand chamando WiFiDeviceInitialize.
A estrutura WiFiCx invoca EvtWifiDeviceSendCommand para emitir uma mensagem de comando para o driver cliente.
Para recuperar a mensagem, o driver cliente chama WifiRequestGetInOutBuffer para obter o buffer de entrada/saída e os comprimentos do buffer. O driver também precisa chamar WifiRequestGetMessageId para recuperar a ID da mensagem.
Para concluir a solicitação, o driver envia o M3 para o comando de forma assíncrona chamando WifiRequestComplete.
Se esse comando for um comando definido e a solicitação original não contiver um buffer grande o suficiente, o cliente deverá chamar WifiRequestSetBytesNeeded para definir o tamanho do buffer necessário e, em seguida, falhar a solicitação com o status BUFFER_OVERFLOW.
Se esse comando for um comando de tarefa, o driver cliente precisará enviar posteriormente a indicação M4 associada chamando WifiDeviceReceiveIndication e passar o buffer de indicação com um cabeçalho WDI que contenha a mesma ID de mensagem contida no M1.
Para obter mais informações, consulte Manipulando mensagens de comando WiFiCx.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11 |
| servidor com suporte mínimo | Windows Server 2022 |
| cabeçalho | wificx.h |
| IRQL | <= DISPATCH_LEVEL |