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 指示,并使用包含与 M1 中包含的相同消息 ID 的 WDI 标头传递指示缓冲区。

有关详细信息,请参阅 处理 WiFiCx 命令消息

要求

要求 价值
最低支持的客户端 Windows 11
支持的最低服务器 Windows Server 2022
标头 wificx.h
IRQL <= DISPATCH_LEVEL

另请参阅

处理 WiFiCx 命令消息

WiFiDeviceInitialize

WifiRequestGetInOutBuffer

WifiRequestGetMessageId

WifiRequestComplete