IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

Этот IOCTL используется приложением или службой радиоуправления для задания состояния радиосвязи устройства близкого взаимодействия. Поле MediaRadioOn используется для указания состояния питания запроса. Если состояние питания близкого взаимодействия отключается, драйвер должен отключить интерфейсы устройств близкого взаимодействия (GUID_DEVINTERFACE_NFP и интерфейсы GUID_DEVINTERFACE_SMARTCARD_READER) и отключить режимы чтения и чтения и записи устройства. Если включено состояние питания близкого взаимодействия, драйвер должен включить интерфейсы устройств близкого взаимодействия и включить режимы чтения и чтения или записи контроллера. Дополнительные сведения об оптимизации режимов питания на этом устройстве см. в NFC Power Management.

Основной код

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, что Windows отправит выходной параметр, отличный от NULL, с этим IOCTL. Эта ошибка исправлена в более поздних версиях Windows. Чтобы упростить код, драйверы могут игнорировать выходные параметры во всех версиях Windows 10.

Требования

Требование Ценность
заголовка nfcradiodev.h