IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
Ce IOCTL est utilisé par l’application ou le service de gestion radio pour définir l’état de l’alimentation radio de l’appareil de proximité. Le champ MediaRadioOn est utilisé pour indiquer l’état de l’alimentation de la requête. Lorsque l’état de l’alimentation radio de proximité est désactivé, le pilote doit désactiver les interfaces de périphérique de proximité (GUID_DEVINTERFACE_NFP et GUID_DEVINTERFACE_SMARTCARD_READER interfaces) et désactiver les modes P2P et lecteur/enregistreur de l’appareil. Si l’état de l’alimentation radio de proximité est activé, le pilote doit activer les interfaces de périphérique de proximité et activer les modes P2P et lecteur/enregistreur du contrôleur. Pour plus d’informations sur l’optimisation des modes d’alimentation sur cet appareil, consultez gestion de l’alimentation NFC.
Code principal
Mémoire tampon d’entrée
NFCRM_SET_RADIO_STATE structure
Longueur de la mémoire tampon d’entrée
sizeof(NFCRM_SET_RADIO_STATE)
Mémoire tampon de sortie
Aucun
Longueur de la mémoire tampon de sortie
Aucun
Bloc d’état
Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Les codes d’erreur possibles sont les suivants :
| Retour du code | Description |
|---|---|
| STATUS_INVALID_DEVICE_STATE | Ce code est retourné lorsque l’appareil est déjà dans l’état de l’alimentation radio de proximité défini par le client. |
Remarques
Le code de retour STATUS_INVALID_PARAMETER n’est plus nécessaire. Un bogue a été découvert dans windows 10 build 10240, que Windows envoie un paramètre de sortie non null avec cette IOCTL. Ce bogue a été résolu dans les versions ultérieures de Windows. Pour simplifier le code, les pilotes peuvent ignorer les paramètres de sortie dans toutes les versions de Windows 10.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | nfcradiodev.h |