IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

Статья
03/01/2024

Этот 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)

Выходной буфер

None

Длина выходного буфера

None

Блок состояния

Irp->IoStatus.Status имеет значение STATUS_SUCCESS , если запрос выполнен успешно. Возможные коды ошибок:

Код возврата	Описание
STATUS_INVALID_DEVICE_STATE	Этот код возвращается, когда устройство уже находится в состоянии радиосвязи близкого взаимодействия, заданном клиентом.

Код возврата STATUS_INVALID_PARAMETER больше не требуется. В Windows 10 сборке 10240 обнаружена ошибка, из-за которую Windows отправляла выходной параметр, отличный от NULL, с этим IOCTL. Эта ошибка была исправлена в более поздних версиях Windows. Чтобы упростить код, драйверы могут игнорировать выходные параметры во всех версиях Windows 10.

Требования

Требование	Значение
Заголовок	nfcradiodev.h

Поделиться через