IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

Esse IOCTL é usado pelo aplicativo ou serviço de gerenciamento de rádio para definir o estado de energia de rádio do dispositivo de proximidade. O campo MediaRadioOn é usado para indicar o estado de energia da solicitação. Quando o estado de energia de rádio de proximidade estiver desabilitado, o driver deverá desabilitar as interfaces de dispositivo de proximidade (interfaces de GUID_DEVINTERFACE_NFP e GUID_DEVINTERFACE_SMARTCARD_READER) e desabilitar os modos P2P e leitor/gravador do dispositivo. Se o estado de energia de rádio de proximidade estiver habilitado, o driver deverá habilitar as interfaces do dispositivo de proximidade e habilitar modos P2P e leitor/gravador do controlador. Para obter mais informações sobre como otimizar modos de energia neste dispositivo, consulte NFC Power Management.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

estrutura NFCRM_SET_RADIO_STATE

Comprimento do buffer de entrada

sizeof(NFCRM_SET_RADIO_STATE)

Buffer de saída

Nenhum

Comprimento do buffer de saída

Nenhum

Bloco de status

Irp-> IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Os códigos de erro possíveis são:

Código de retorno Descrição
STATUS_INVALID_DEVICE_STATE Esse código é retornado quando o dispositivo já está no estado de energia de rádio de proximidade que está sendo definido pelo cliente.

Comentários

O código de retorno STATUS_INVALID_PARAMETER não é mais necessário. Um bug foi descoberto no Windows 10 build 10240, que o Windows enviaria um parâmetro de saída não nulo com esse IOCTL. Esse bug foi corrigido em versões posteriores do Windows. Para simplificar o código, os drivers podem ignorar os parâmetros de saída em todas as versões do Windows 10.

Requisitos

   
Cabeçalho nfcradiodev.h