IOCTL_NFCRM_SET_RADIO_STATE IOCTL (нфкрадиодев. h)

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

Структура NFCRM_SET_RADIO_STATE

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

sizeof (NFCRM_SET_RADIO_STATE)

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

Нет

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

Нет

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

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

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

Remarks

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

Требования

Header	нфкрадиодев. h