IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
Ce IOCTL est utilisé par l’application ou le service de gestion des radios pour définir l’état d’alimentation radio de l’appareil de proximité. Le champ MediaRadioOn est utilisé pour indiquer l’état d’alimentation de la demande. Lorsque l’état d’alimentation radio de proximité est désactivé, le pilote doit désactiver les interfaces de périphérique de proximité (interfaces GUID_DEVINTERFACE_NFP et GUID_DEVINTERFACE_SMARTCARD_READER) et désactiver les modes P2P et lecteur/enregistreur de l’appareil. Si l’état d’alimentation de la radio de proximité est activé, le pilote doit activer les interfaces du 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
structure NFCRM_SET_RADIO_STATE
Longueur de la mémoire tampon d’entrée
sizeof(NFCRM_SET_RADIO_STATE)
Mémoire tampon de sortie
None
Longueur de la mémoire tampon de sortie
None
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 :
Code de retour | Description |
---|---|
STATUS_INVALID_DEVICE_STATE | Ce code est retourné lorsque l’appareil est déjà dans l’état d’alimentation radio de proximité défini par le client. |
Remarques
Le code de retour STATUS_INVALID_PARAMETER n’est plus requis. Un bogue a été détecté dans Windows 10 build 10240, selon lequel Windows enverrait un paramètre de sortie non null avec cette durée de vie 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.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | nfcradiodev.h |