IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
无线电管理应用程序或服务使用此 IOCTL 来设置邻近感应设备的无线电电源状态。 MediaRadioOn 字段用于指示请求电源状态。 禁用邻近无线电电源状态时,驱动程序应禁用邻近设备接口 (GUID_DEVINTERFACE_NFP 和GUID_DEVINTERFACE_SMARTCARD_READER接口) ,并禁用设备的 P2P 和读取器/写入器模式。 如果启用了邻近无线电电源状态,驱动程序应启用邻近感应设备接口,并启用控制器的 P2P 和读取器/写入器模式。 有关优化此设备上的电源模式的详细信息,请参阅 NFC 电源管理。
主要代码
输入缓冲区
输入缓冲区长度
sizeof (NFCRM_SET_RADIO_STATE)
输出缓冲区
无
输出缓冲区长度
无
状态块
Irp->如果请求成功,IoStatus.Status 设置为 STATUS_SUCCESS 。 可能的错误代码包括:
返回代码 | 说明 |
---|---|
STATUS_INVALID_DEVICE_STATE | 当设备已处于由客户端设置的邻近无线电电源状态时,将返回此代码。 |
注解
不再需要STATUS_INVALID_PARAMETER返回代码。 Windows 10内部版本 10240 中发现了一个 bug,即 Windows 会使用此 IOCTL 发送非 null 输出参数。 此 bug 已在更高版本的 Windows 中修复。 为了简化代码,驱动程序可以忽略所有版本的 Windows 10 中的输出参数。
要求
要求 | 值 |
---|---|
Header | nfcradiodev.h |