IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
Questo IOCTL viene usato dall'applicazione o dal servizio di gestione radio per impostare lo stato di alimentazione radio del dispositivo di prossimità. Il campo MediaRadioOn viene usato per indicare lo stato di alimentazione della richiesta. Quando lo stato di alimentazione radio di prossimità è disabilitato, il driver deve disabilitare le interfacce del dispositivo di prossimità (GUID_DEVINTERFACE_NFP e GUID_DEVINTERFACE_SMARTCARD_READER interfacce) e disabilitare le modalità P2P e reader/writer del dispositivo. Se lo stato di alimentazione radio di prossimità è abilitato, il driver deve abilitare le interfacce del dispositivo di prossimità e abilitare le modalità P2P e lettore/writer del controller. Per altre informazioni sull'ottimizzazione delle modalità di alimentazione in questo dispositivo, vedere Power Management NFC.
Codice principale
Buffer di input
NFCRM_SET_RADIO_STATE struttura
Lunghezza del buffer di input
sizeof(NFCRM_SET_RADIO_STATE)
Buffer di output
Nessuno
Lunghezza del buffer di output
Nessuno
Blocco dello stato
Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. I codici di errore possibili sono:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_DEVICE_STATE | Questo codice viene restituito quando il dispositivo si trova già nello stato di alimentazione radio di prossimità impostato dal client. |
Commenti
Il codice restituito STATUS_INVALID_PARAMETER non è più necessario. Un bug è stato rilevato in Windows 10 build 10240, che Windows inviava un parametro di output non null con questo IOCTL. Questo bug è stato risolto nelle versioni successive di Windows. Per semplificare il codice, i driver possono ignorare i parametri di output in tutte le versioni di Windows 10.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | nfcradiodev.h |