EVT_WIFI_DEVICE_SEND_COMMAND función de devolución de llamada (wificx.h)

Artículo
02/27/2024

Una función de devolución de llamada EvtWifiDeviceSendCommand del controlador WiFiCx recupera y procesa un mensaje de comando enviado por el marco WiFiCx.

Sintaxis

EVT_WIFI_DEVICE_SEND_COMMAND EvtWifiDeviceSendCommand;

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

Parámetros

Device

[In] Identificador de un objeto de dispositivo de marco que el controlador cliente obtuvo de una llamada anterior a WdfDeviceCreate.

SendRequest

[In] Identificador de un objeto WIFIREQUEST de marco que representa un mensaje de comando.

Valor devuelto

None

Observaciones

Un controlador cliente WiFiCx debe registrar su función de devolución de llamada EvtWifiDeviceSendCommand llamando a WiFiDeviceInitialize.

El marco WiFiCx invoca EvtWifiDeviceSendCommand para emitir un mensaje de comando al controlador cliente.

Para recuperar el mensaje, el controlador cliente llama a WifiRequestGetInOutBuffer para obtener las longitudes de búfer de entrada y salida. El controlador también debe llamar a WifiRequestGetMessageId para recuperar el identificador del mensaje.
Para completar la solicitud, el controlador envía el M3 para el comando de forma asincrónica llamando a WifiRequestComplete.
Si este comando es un comando set y la solicitud original no contenía un búfer lo suficientemente grande, el cliente debe llamar a WifiRequestSetBytesNeeded para establecer el tamaño de búfer necesario y, a continuación, producir un error en la solicitud con estado BUFFER_OVERFLOW.
Si este comando es un comando de tarea, el controlador cliente debe enviar posteriormente la indicación M4 asociada llamando a WifiDeviceReceiveIndication y pasar el búfer de indicación con un encabezado WDI que contiene el mismo identificador de mensaje que el contenido en M1.