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 della 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 della radio di prossimità è abilitato, il driver deve abilitare le interfacce del dispositivo di prossimità e abilitare le modalità P2P e reader/writer del controller. Per altre informazioni sull'ottimizzazione delle modalità di alimentazione in questo dispositivo, vedere NFC Power Management.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

struttura NFCRM_SET_RADIO_STATE

Lunghezza del buffer di input

sizeof(NFCRM_SET_RADIO_STATE)

Buffer di output

Nessuno

Lunghezza del buffer di output

Nessuno

Blocco di 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.

Osservazioni

Il codice restituito STATUS_INVALID_PARAMETER non è più necessario. È stato rilevato un bug 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.

Fabbisogno

Requisito	Valore
intestazione	nfcradiodev.h