EVT_WIFI_DEVICE_SEND_COMMAND função de retorno de chamada (wificx.h)

Artigo
08/08/2023

A função de retorno de chamada EvtWifiDeviceSendCommand de um driver WiFiCx 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

[In] Um identificador para um objeto de dispositivo de estrutura que o driver cliente obteve de uma chamada anterior para WdfDeviceCreate.

SendRequest

[In] Um identificador para um objeto WIFIREQUEST de estrutura que representa uma mensagem de comando.

Retornar valor

Nenhum

Comentários

Um driver de 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 do 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 set 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 status BUFFER_OVERFLOW.
Se esse comando for um comando de tarefa, o driver do cliente precisará enviar posteriormente a indicação M4 associada chamando WifiDeviceReceiveIndication e passar o buffer de indicação com um cabeçalho WDI que contém a mesma ID de mensagem contida no M1.