IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

无线电管理应用程序或服务使用此 IOCTL 来设置邻近感应设备的无线电电源状态。 MediaRadioOn 字段用于指示请求电源状态。 禁用邻近无线电电源状态时,驱动程序应禁用邻近设备接口 (GUID_DEVINTERFACE_NFP 和GUID_DEVINTERFACE_SMARTCARD_READER接口) ,并禁用设备的 P2P 和读取器/写入器模式。 如果启用了邻近无线电电源状态,驱动程序应启用邻近感应设备接口,并启用控制器的 P2P 和读取器/写入器模式。 有关优化此设备上的电源模式的详细信息,请参阅 NFC 电源管理

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

NFCRM_SET_RADIO_STATE 结构

输入缓冲区长度

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