Partager via


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

IRP_MJ_DEVICE_CONTROL

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