EVT_WIFI_DEVICE_SEND_COMMAND回调函数 (wificx.h)

WiFiCx 驱动程序的 EvtWifiDeviceSendCommand 回调函数检索并处理 WiFiCx 框架发送的命令消息。

语法

EVT_WIFI_DEVICE_SEND_COMMAND EvtWifiDeviceSendCommand;

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

Device

[In]客户端驱动程序从上一次调用 WdfDeviceCreate 获取的框架设备对象的句柄。

SendRequest

[In]表示命令消息的框架 WIFIREQUEST 对象的句柄。

无

WiFiCx 客户端驱动程序必须通过调用 WiFiDeviceInitialize 注册其 EvtWifiDeviceSendCommand 回调函数。

WiFiCx 框架调用 EvtWifiDeviceSendCommand 向客户端驱动程序发出命令消息。

为了检索消息，客户端驱动程序调用 WifiRequestGetInOutBuffer 来获取输入/输出缓冲区和缓冲区长度。驱动程序还需要调用 WifiRequestGetMessageId 来检索消息 ID。
若要完成请求，驱动程序通过调用 WifiRequestComplete 异步发送命令的 M3。
如果此命令是 set 命令，并且原始请求不包含足够大的缓冲区，则客户端应调用 WifiRequestSetBytesNeeded 来设置所需的缓冲区大小，然后使请求失败，状态BUFFER_OVERFLOW。
如果此命令是任务命令，则客户端驱动程序稍后需要通过调用 WifiDeviceReceiveIndication 发送关联的 M4 指示，并使用 WDI 标头传递指示缓冲区，该标头包含与 M1 中包含的消息 ID 相同的消息 ID。