Communications en champ proche (NFC)

Vue d’ensemble de la technologie NFC (Near Field Communications).

Pour développer des communications en champ proche (NFC), vous avez besoin des en-têtes suivants :

• nfccx.h
• nfcradiodev.h
• nfcsedev.h
• nfpdev.h
• winsmcrd.h

Pour obtenir le guide de programmation, consultez Communications en champ proche (NFC).

IOCTLs

IOCTL_NFCRM_QUERY_RADIO_STATE Cet IOCTL est utilisé par l’application ou le service de gestion radio pour interroger l’état actuel de l’alimentation radio de l’appareil de proximité.
IOCTL_NFCRM_SET_RADIO_STATE Cet IOCTL est utilisé par l’application ou le service de gestion radio pour définir l’état d’alimentation radio de l’appareil de proximité.
IOCTL_NFCSE_ENUM_ENDPOINTS Retourne des informations concernant la liste de tous les éléments sécurisés attachés au contrôleur NFC.
IOCTL_NFCSE_GET_NEXT_EVENT Le code de contrôle IOCTL_NFCSE_GET_NEXT_EVENT retourne l’événement suivant disponible dans la mémoire tampon, ou s’il n’y a plus d’événements mis en mémoire tampon en attente jusqu’à ce qu’un événement d’élément sécurisé soit disponible. Les détails de l’événement doivent ensuite être retournés à l’appelant.
IOCTL_NFCSE_GET_NFCC_CAPABILITIES Le code de contrôle IOCTL_NFCSE_GET_NFCC_CAPABILITIES retourne des informations sur les fonctionnalités actuelles du contrôleur NFC, y compris la taille maximale de la table de routage en mode d’écoute (définie dans la section 4.2 de la spécification technique de l’interface de contrôleur NFC (NCI) version 1.1) et les modes de routage pris en charge.
IOCTL_NFCSE_GET_ROUTING_TABLE Retourne des informations concernant la configuration actuelle de la table de routage en mode d’écoute.
IOCTL_NFCSE_HCE_REMOTE_RECV Retourne la mémoire tampon de données suivante disponible ou, s’il n’y a plus de données mises en mémoire tampon, la requête reste en attente jusqu’à ce qu’une mémoire tampon APDU soit disponible pour la lecture.
IOCTL_NFCSE_HCE_REMOTE_SEND Transmet l’APDU de réponse de DeviceHost NFCEE à l’appareil distant. L’appelant doit s’assurer que la réponse APDU est conforme à la norme ISO-IEC 7816-4.
IOCTL_NFCSE_SET_CARD_EMULATION_MODE Le code de contrôle IOCTL_NFCSE_SET_CARD_EMULATION_MODE définit si l’élément sécurisé spécifié est exposé en mode d’émulation carte.
IOCTL_NFCSE_SET_ROUTING_TABLE Configure la table de routage du mode d’écoute du contrôleur NFC.
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Le code de contrôle IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT est émis par un client pour s’abonner à un événement spécifique.
IOCTL_NFCSERM_QUERY_RADIO_STATE Le IOCTL_NFCSERM_QUERY_RADIO_STATE est utilisé par l’application ou le service de gestion de la radio SE pour interroger l’état actuel de l’alimentation radio de l’appareil de proximité.
IOCTL_NFCSERM_SET_RADIO_STATE Le IOCTL_NFCSERM_SET_RADIO_STATE est utilisé par l’application ou le service de gestion de la radio SE pour définir l’état d’alimentation radio actuel de l’appareil de proximité.
IOCTL_NFP_DISABLE Un client envoie la demande IOCTL_NFP_DISABLE pour désactiver temporairement les abonnements, les publications et les événements de présence.
IOCTL_NFP_ENABLE Le client envoie la demande de IOCTL_NFP_ENABLE pour réactiver les abonnements, les publications et les événements de présence précédemment désactivés.
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Un client envoie la demande de IOCTL_NFP_GET_KILO_BYTES_PER_SECOND à n’importe quel handle générique, non publié et non abonné, à l’appareil du fournisseur.
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Un client envoie la demande de IOCTL_NFP_GET_MAX_MESSAGE_BYTES à n’importe quel handle générique, non publié et non abonné, à l’appareil du fournisseur pour déterminer la taille maximale de message prise en charge.
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Le client envoie la demande de IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE au handle d’abonnement à plusieurs reprises afin de recevoir les messages abonnés à mesure qu’ils arrivent.
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Un client qui souhaite recevoir des notifications indiquant qu’un message a été transmis envoie la demande de IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE au pilote de proximité.
IOCTL_NFP_SET_PAYLOAD Une application cliente envoie des données de message et confirme la publication avec la demande de IOCTL_NFP_SET_PAYLOAD.
IOCTL_SMARTCARD_GET_ATTRIBUTE Le code de contrôle IOCTL_SMARTCARD_GET_ATTRIBUTE interroge les attribues smart carte.
IOCTL_SMARTCARD_GET_STATE Le code de contrôle IOCTL_SMARTCARD_GET_STATE obtient la status actuelle du carte intelligent.
IOCTL_SMARTCARD_IS_ABSENT Le code de contrôle IOCTL_SMARTCARD_IS_ABSENT retourne immédiatement avec STATUS_SUCCESS si aucune carte intelligente n’est actuellement détectée.
IOCTL_SMARTCARD_IS_PRESENT Le code de contrôle IOCTL_SMARTCARD_IS_PRESENT détecte si un carte intelligent est actuellement détecté.
IOCTL_SMARTCARD_POWER Windows peut exiger qu’un pilote ait cet IOCTL comme NOP et retourne la réussite.
IOCTL_SMARTCARD_SET_ATTRIBUTE Le code de contrôle IOCTL_SMARTCARD_SET_ATTRIBUTE définit un attribut et retourne STATUS_SUCCESS sur SCARD_ATTR_DEVICE_IN_USE ; sinon, elle retourne STATUS_NOT_SUPPORTED.
IOCTL_SMARTCARD_SET_PROTOCOL Définit le procotol que le pilote communique avec le carte intelligent une fois le carte détecté.
IOCTL_SMARTCARD_TRANSMIT Transmet les données du client au carte intelligent détecté dans l’API conforme ISO7816-4.

Énumérations

NFC_CX_CE_MODE_CONFIG Cette énumération spécifie les indicateurs de mode d’écoute CE.
NFC_CX_DEVICE_MODE Spécifie les indicateurs de mode d’appareil.
NFC_CX_DRIVER_FLAGS Spécifie les indicateurs de pilote d’exécution.
NFC_CX_HOST_ACTION L’énumération NFC_CX_HOST_ACTION spécifie les actions de l’hôte.
NFC_CX_NFCIP_MODE_CONFIG L’énumération NFC_CX_NFCIP_MODE_CONFIG spécifie le mode initiateur NFC-IP.
NFC_CX_NFCIP_TGT_MODE_CONFIG L’énumération NFC_CX_NFCIP_TGT_MODE_CONFIG spécifie le mode cible NFC-IP.
NFC_CX_POLL_BAILOUT_CONFIG L’énumération NFC_CX_POLL_BAILOUT_CONFIG spécifie le mode d’interrogation de bail out.
NFC_CX_POLL_MODE_CONFIG L’énumération NFC_CX_POLL_MODE_CONFIG spécifie le mode d’interrogation.
NFC_CX_SEQUENCE L’énumération NFC_CX_SEQUENCE spécifie des séquences.
NFC_CX_TRANSPORT_TYPE L’énumération NFC_CX_TRANSPORT_TYPE spécifie les types de transport.
SECURE_ELEMENT_CARD_EMULATION_MODE Cette énumération indique le mode d’émulation carte d’un élément sécurisé.
SECURE_ELEMENT_EVENT_TYPE Indique le type d’événements d’élément sécurisé.
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE est membre de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_TYPE Indique le type d’un élément sécurisé.

Fonctions

EVT_NFC_CX_DEVICE_IO_CONTROL Appelé par nfc CX pour envoyer un IOCTL non pris en charge au pilote client.
EVT_NFC_CX_SEQUENCE_HANDLER Appelé par le CX NFC pour avertir le pilote client de gérer la séquence inscrite spécifique.
EVT_NFC_CX_WRITE_NCI_PACKET Appelé par NFC CX pour envoyer un paquet d’écriture au pilote client.
NFC_CX_CLIENT_CONFIG_INIT La fonction NFC_CX_CLIENT_CONFIG_INIT initialise la structure NFC_CX_CLIENT_CONFIG.
NFC_CX_LLCP_CONFIG_INIT La fonction NFC_CX_LLCP_CONFIG_INIT initialise la structure NFC_CX_LLCP_CONFIG.
NFC_CX_RF_DISCOVERY_CONFIG_INIT La fonction NFC_CX_RF_DISCOVERY_CONFIG_INIT initialise la structure NFC_CX_RF_DISCOVERY_CONFIG.
NfcCxDeviceDeinitialize La fonction NfcCxDeviceDeinitialize (nfccx.h) désinitialise un appareil WDF qui a été créé pendant la routine AddDevice.
NfcCxDeviceInitConfig Appelé par le pilote client pendant sa routine AddDevice pour effectuer des fonctions DeviceInit. Au cours de ce processus, les fonctions de rappel d’E/S suivantes sont également échangées.
NfcCxDeviceInitialize La fonction NfcCxDeviceInitialize (nfccx.h) initialise un appareil WDF qui a été créé pendant la routine AddDevice.
NfcCxHardwareEvent Appelé par le pilote client lorsqu’un événement matériel se produit, comme D0Entry et D0Exit, rappelle pour démarrer ou arrêter l’appareil. Pour les pilotes qui nécessitent le téléchargement du microprogramme lors de l’initialisation ou du démarrage, il est recommandé de déplacer cet appel vers un élément de travail distinct. Toutefois, le pilote client est responsable de ce qui suit.
NfcCxNciReadNotification Appelé par le pilote client lorsqu’un paquet de lecture est disponible.
NfcCxRegisterSequenceHandler Appelé par le pilote client lors de l’initialisation pour s’inscrire pour gérer des séquences spécifiques.
NfcCxSetLlcpConfig Appelé par le pilote client pour configurer les paramètres LLCP.
NfcCxSetRfDiscoveryConfig Appelé par le pilote client pour configurer les paramètres de découverte RF.
NfcCxUnregisterSequenceHandler Appelé par le pilote client lors de l’arrêt de l’appareil pour annuler l’inscription pour le rappel du gestionnaire de séquence précédemment inscrit.

Structures

NFC_CX_CLIENT_CONFIG La structure NFC_CX_CLIENT_CONFIG est un paramètre d’entrée de NfcCxDeviceInitConfig.
NFC_CX_HARDWARE_EVENT La structure NFC_CX_HARDWARE_EVENT est un paramètre d’entrée de NfcCxHardwareEvent.
NFC_CX_LLCP_CONFIG La structure NFC_CX_LLCP_CONFIG est un paramètre d’entrée de NfcCxSetLlcpConfig.
NFC_CX_RF_DISCOVERY_CONFIG La structure NFC_CX_RF_DISCOVERY_CONFIG contient les paramètres de configuration de la découverte RF. La configuration de la découverte doit être effectuée lors de l’initialisation après l’appel de NfcDxDeviceInitialize, sinon une erreur est retournée.
NFCCX_DRIVER_GLOBALS La structure _NFCCX_DRIVER_GLOBALS contient des valeurs globales pour le pilote CX NFC (Near Field Communications).
NFCRM_RADIO_STATE Cette structure est utilisée pour indiquer l’état radio.
NFCRM_SET_RADIO_STATE Cette structure est utilisée pour définir l’état radio. Le pilote, dans le cas du mode avion, doit conserver l’état radio et le restaurer lorsque le mode avion est désactivé.
SCARD_IO_REQUEST Cette structure est utilisée pour identifier une demande d’E/S intelligente carte.
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO est membre de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO est membre de SECURE_ELEMENT_ENDPOINT_LIST.
SECURE_ELEMENT_ENDPOINT_LIST Paramètre de sortie pour IOCTL_NFCSE_ENUM_ENDPOINTS.
SECURE_ELEMENT_EVENT_INFO Cette structure fournit des informations sur un événement d’élément sécurisé.
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO La structure SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO est un paramètre d’entrée à IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT.
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD La structure _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD contient un identificateur de connexion unique et des types de technologies et de protocoles NFC Forum RF.
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET est une mémoire tampon d’entrée pour IOCTL_NFCSE_HCE_REMOTE_SEND et la mémoire tampon de sortie pour IOCTL_NFCSE_HCE_REMOTE_RECV.
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES contient des fonctionnalités de contrôleur NFC.
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO est membre de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE est un paramètre d’entrée pour IOCTL_NFCSE_SET_ROUTING_TABLE.
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY est membre de SECURE_ELEMENT_ROUTING_TABLE.
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO est le paramètre d’entrée pour IOCTL_NFCSE_SET_CARD_EMULATION_MODE.
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO est membre de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.