IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
Esse IOCTL é usado pelo serviço ou aplicativo 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 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 os modos P2P e leitor/gravador do controlador. Para obter mais informações sobre como otimizar os modos de energia neste dispositivo, consulte Nfc Power Management.
Código principal
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
| Requisito | Valor |
|---|---|
| Cabeçalho | nfcradiodev.h |