Communications en champ proche (NFC)
Vue d’ensemble de la technologie NFC (Near Field Communications).
Pour développer des communications de champ proche (NFC), vous avez besoin de ces en-têtes :
Pour obtenir le guide de programmation, consultez de communications de champ proche (NFC).
IOCTLs
IOCTL_NFCRM_QUERY_RADIO_STATE Ce 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 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é. |
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 reste 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, notamment la taille maximale de la table de routage du mode d’écoute (définie dans la section 4.2 de la spécification technique NCI (NFC Controller Interface) 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 du 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 à un appareil distant. L’appelant doit être sûr que l’APDU de réponse est conforme à 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 de 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 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 radio SE pour définir l’état actuel de l’alimentation radio de l’appareil de proximité. |
IOCTL_NFP_DISABLE Un client envoie la demande de 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, publications et événements de présence précédemment désactivés. |
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Un client envoie la requête IOCTL_NFP_GET_KILO_BYTES_PER_SECOND à n’importe quel handle générique, qui n’est pas publié et non abonné, à l’appareil fournisseur. |
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Un client envoie la demande IOCTL_NFP_GET_MAX_MESSAGE_BYTES à n’importe quel handle générique, qui n’est pas publié et non abonné, à l’appareil 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 à l’abonnement à plusieurs reprises afin de recevoir des messages abonnés dès qu’ils arrivent. |
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Un client intéressé par la réception de notifications 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 Les requêtes de code de contrôle IOCTL_SMARTCARD_GET_ATTRIBUTE pour les attributs de carte à puce. |
IOCTL_SMARTCARD_GET_STATE Le code de contrôle IOCTL_SMARTCARD_GET_STATE obtient l’état actuel de la carte à puce. |
IOCTL_SMARTCARD_IS_ABSENT Le code de contrôle IOCTL_SMARTCARD_IS_ABSENT retourne immédiatement avec STATUS_SUCCESS si aucune carte à puce n’est actuellement détectée. |
IOCTL_SMARTCARD_IS_PRESENT Le code de contrôle IOCTL_SMARTCARD_IS_PRESENT détecte si une carte à puce est actuellement détectée. |
IOCTL_SMARTCARD_POWER Windows peut exiger qu’un pilote ait ce IOCTL pour qu’il soit NOP et retourner 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 la carte à puce après la détection de la carte. |
IOCTL_SMARTCARD_TRANSMIT Transmet les données du client à la carte à puce détectée dans ISO7816-4 APDU conforme. |
É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 appareil. |
NFC_CX_DRIVER_FLAGS Spécifie les indicateurs de pilote au moment de l’exécution. |
NFC_CX_HOST_ACTION L’énumération NFC_CX_HOST_ACTION spécifie les actions d’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 NFC-IP mode cible. |
NFC_CX_POLL_BAILOUT_CONFIG L’énumération NFC_CX_POLL_BAILOUT_CONFIG spécifie le mode de sondage de sauvetage. |
NFC_CX_POLL_MODE_CONFIG L’énumération NFC_CX_POLL_MODE_CONFIG spécifie le mode de sondage. |
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 de 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 le NFC CX pour envoyer un IOCTL non géré au pilote client. |
EVT_NFC_CX_SEQUENCE_HANDLER Appelé par nfc CX pour avertir le pilote client de gérer la séquence inscrite spécifique. |
EVT_NFC_CX_WRITE_NCI_PACKET Appelé par le 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 créé pendant la routine AddDevice. |
NfcCxDeviceInitConfig Appelé par le pilote client pendant sa routine AddDevice pour exécuter des fonctions DeviceInit. Pendant ce processus, les fonctions de rappel d’E/S suivantes sont également échangées. |
NfcCxDeviceInitialize La fonction NfcCxDeviceInitialize (nfccx.h) initialise un appareil WDF créé pendant la routine AddDevice. |
NfcCxHardwareEvent Appelé par le pilote client lorsqu’un événement matériel se produit comme des rappels D0Entry et D0Exit 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 des éléments suivants. |
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 pour NfcCxDeviceInitConfig. |
NFC_CX_HARDWARE_EVENT La structure NFC_CX_HARDWARE_EVENT est un paramètre d’entrée pour NfcCxHardwareEvent. |
NFC_CX_LLCP_CONFIG La structure NFC_CX_LLCP_CONFIG est un paramètre d’entrée pour NfcCxSetLlcpConfig. |
NFC_CX_RF_DISCOVERY_CONFIG La structure NFC_CX_RF_DISCOVERY_CONFIG contient des paramètres de configuration de découverte RF. La configuration de découverte doit être terminé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 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, en cas de 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 de carte à puce. |
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 protocole RF du Forum NFC. |
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 de IOCTL_NFCSE_SET_CARD_EMULATION_MODE. |
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO est membre de SECURE_ELEMENT_ROUTING_TABLE_ENTRY. |