IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
Esta IOCTL la utiliza la aplicación de administración de radio o el servicio para establecer el estado de alimentación de radio del dispositivo de proximidad. El campo MediaRadioOn se usa para indicar el estado de energía de la solicitud. Cuando el estado de alimentación de radio de proximidad está deshabilitado, el controlador debe deshabilitar las interfaces de dispositivo de proximidad (GUID_DEVINTERFACE_NFP y GUID_DEVINTERFACE_SMARTCARD_READER interfaces) y deshabilitar los modos P2P y lector/escritor del dispositivo. Si el estado de energía de radio de proximidad está habilitado, el controlador debe habilitar las interfaces de dispositivo de proximidad y habilitar los modos P2P y lector/escritor del controlador. Para obtener más información sobre cómo optimizar los modos de alimentación en este dispositivo, consulte Administración de energía NFC.
Código principal
Búfer de entrada
estructura de NFCRM_SET_RADIO_STATE
Longitud del búfer de entrada
sizeof(NFCRM_SET_RADIO_STATE)
Búfer de salida
None
Longitud del búfer de salida
None
Bloque de estado
Irp->IoStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. Los posibles códigos de error son:
| Código de retorno | Descripción |
|---|---|
| STATUS_INVALID_DEVICE_STATE | Este código se devuelve cuando el dispositivo ya está en el estado de energía de radio de proximidad que el cliente establece. |
Comentarios
El STATUS_INVALID_PARAMETER código de retorno ya no es necesario. Se detectó un error en Windows 10 compilación 10240, que Windows enviaría un parámetro de salida no NULL con este IOCTL. Este error se corrigió en versiones posteriores de Windows. Para simplificar el código, los controladores pueden omitir los parámetros de salida en todas las versiones de Windows 10.
Requisitos
| Requisito | Valor |
|---|---|
| Header | nfcradiodev.h |