Near Field Communications (NFC)

Übersicht über die Nfc-Technologie (Near Field Communications).

Für die Entwicklung von Near Field Communications (NFC) benötigen Sie die folgenden Header:

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

Den Programmierleitfaden finden Sie unter Near Field Communications (NFC).

IOCTLs

IOCTL_NFCRM_QUERY_RADIO_STATE Diese IOCTL wird von der Funkverwaltungsanwendung oder dem Dienst verwendet, um den aktuellen Funkleistungszustand des Näherungsgeräts abzufragen.
IOCTL_NFCRM_SET_RADIO_STATE Diese IOCTL wird von der Funkverwaltungsanwendung oder dem Dienst verwendet, um den Funkleistungszustand des Näherungsgeräts festzulegen.
IOCTL_NFCSE_ENUM_ENDPOINTS Gibt Informationen über die Liste aller sicheren Elemente zurück, die an den NFC-Controller angefügt sind.
IOCTL_NFCSE_GET_NEXT_EVENT Der IOCTL_NFCSE_GET_NEXT_EVENT-Steuerelementcode gibt das nächste im Puffer verfügbare Ereignis zurück, oder wenn keine gepufferten Ereignisse mehr vorhanden sind, bleibt aus, bis ein Sicheres Elementereignis verfügbar ist. Die Ereignisdetails müssen dann an den Aufrufer zurückgegeben werden.
IOCTL_NFCSE_GET_NFCC_CAPABILITIES Der IOCTL_NFCSE_GET_NFCC_CAPABILITIES-Steuerungscode gibt Informationen zu den aktuellen NFC-Controllerfunktionen zurück, einschließlich der maximalen Größe der Routingtabelle für den Listenmodus (definiert in Abschnitt 4.2 der NCI-Spezifikation Version 1.1) und der unterstützten Routingmodi.
IOCTL_NFCSE_GET_ROUTING_TABLE Gibt Informationen zur aktuellen Konfiguration der Routingtabelle für den Listenmodus zurück.
IOCTL_NFCSE_HCE_REMOTE_RECV Gibt entweder den nächsten verfügbaren Datenpuffer zurück, oder wenn keine gepufferten Daten mehr vorhanden sind, bleibt die Anforderung ausstehend, bis ein APDU-Puffer zum Lesen verfügbar ist.
IOCTL_NFCSE_HCE_REMOTE_SEND Überträgt antwort-APDU von DeviceHost NFCEE an ein Remotegerät. Der Aufrufer muss sicherstellen, dass die Antwort-APDU iso-IEC 7816-4 entspricht.
IOCTL_NFCSE_SET_CARD_EMULATION_MODE Der IOCTL_NFCSE_SET_CARD_EMULATION_MODE-Steuerungscode legt fest, ob das angegebene sichere Element im emulationsmodus Karte verfügbar gemacht wird.
IOCTL_NFCSE_SET_ROUTING_TABLE Konfiguriert die Routingtabelle des NFC-Controllers im Lauschmodus.
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Der IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Steuercode wird von einem Client ausgegeben, um ein bestimmtes Ereignis zu abonnieren.
IOCTL_NFCSERM_QUERY_RADIO_STATE Der IOCTL_NFCSERM_QUERY_RADIO_STATE wird von der SE-Funkverwaltungsanwendung oder dem Dienst verwendet, um den aktuellen Funkleistungszustand des Näherungsgeräts abzufragen.
IOCTL_NFCSERM_SET_RADIO_STATE Der IOCTL_NFCSERM_SET_RADIO_STATE wird von der SE-Funkverwaltungsanwendung oder dem Dienst verwendet, um den aktuellen Funkstromzustand des Näherungsgeräts festzulegen.
IOCTL_NFP_DISABLE Ein Client sendet die IOCTL_NFP_DISABLE Anforderung zum vorübergehenden Deaktivieren von Abonnements, Veröffentlichungen und Anwesenheitsereignissen.
IOCTL_NFP_ENABLE Der Client sendet die IOCTL_NFP_ENABLE Anforderung, um zuvor deaktivierte Abonnements, Veröffentlichungen und Anwesenheitsereignisse erneut zu aktivieren.
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Ein Client sendet die IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Anforderung an ein beliebiges generisches Handle, das nicht veröffentlicht und nicht abonniert ist, an das Anbietergerät.
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Ein Client sendet die IOCTL_NFP_GET_MAX_MESSAGE_BYTES-Anforderung an ein beliebiges generisches Handle, das nicht veröffentlicht und nicht abonniert ist, an das Anbietergerät, um die maximal unterstützte Nachrichtengröße zu ermitteln.
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Der Client sendet die IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Anforderung wiederholt an das Abonnementhandle, um abonnierte Nachrichten beim Eingang zu empfangen.
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Ein Client, der Benachrichtigungen erhalten möchte, dass eine Nachricht übertragen wurde, sendet die IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE-Anforderung an den Näherungstreiber.
IOCTL_NFP_SET_PAYLOAD Eine Clientanwendung sendet Nachrichtendaten und bestätigt die Veröffentlichung mit der IOCTL_NFP_SET_PAYLOAD-Anforderung.
IOCTL_SMARTCARD_GET_ATTRIBUTE Die IOCTL_SMARTCARD_GET_ATTRIBUTE Steuern von Codeabfragen für intelligente Karte Attribues.
IOCTL_SMARTCARD_GET_STATE Der IOCTL_SMARTCARD_GET_STATE-Steuerungscode ruft den aktuellen status des intelligenten Karte ab.
IOCTL_SMARTCARD_IS_ABSENT Der IOCTL_SMARTCARD_IS_ABSENT-Steuerungscode wird sofort mit STATUS_SUCCESS zurückgegeben, wenn derzeit keine intelligente Karte erkannt wird.
IOCTL_SMARTCARD_IS_PRESENT Der IOCTL_SMARTCARD_IS_PRESENT Kontrollcode erkennt, ob derzeit eine intelligente Karte erkannt wird.
IOCTL_SMARTCARD_POWER Windows erfordert möglicherweise, dass ein Treiber über diese IOCTL verfügt, um NOP zu sein und erfolglos zu sein.
IOCTL_SMARTCARD_SET_ATTRIBUTE Der IOCTL_SMARTCARD_SET_ATTRIBUTE-Steuerelementcode legt ein Attribut fest und gibt STATUS_SUCCESS für SCARD_ATTR_DEVICE_IN_USE zurück. Andernfalls wird STATUS_NOT_SUPPORTED zurückgegeben.
IOCTL_SMARTCARD_SET_PROTOCOL Legt den Wert fest, mit dem der Treiber mit dem intelligenten Karte kommuniziert, nachdem die Karte erkannt wurde.
IOCTL_SMARTCARD_TRANSMIT Überträgt Daten vom Client an die erkannte intelligente Karte in ISO7816-4-konformer APDU.

Enumerationen

NFC_CX_CE_MODE_CONFIG Diese Enumeration gibt CE-Überwachungsmodusflags an.
NFC_CX_DEVICE_MODE Gibt Gerätemodusflags an.
NFC_CX_DRIVER_FLAGS Gibt Laufzeittreiberflags an.
NFC_CX_HOST_ACTION Die NFC_CX_HOST_ACTION-Enumeration gibt Hostaktionen an.
NFC_CX_NFCIP_MODE_CONFIG Die NFC_CX_NFCIP_MODE_CONFIG-Enumeration gibt den NFC-IP-Initiatormodus an.
NFC_CX_NFCIP_TGT_MODE_CONFIG Die NFC_CX_NFCIP_TGT_MODE_CONFIG-Enumeration gibt den NFC-IP-Zielmodus an.
NFC_CX_POLL_BAILOUT_CONFIG Die NFC_CX_POLL_BAILOUT_CONFIG-Enumeration gibt die Abrufmodusrettung an.
NFC_CX_POLL_MODE_CONFIG Die NFC_CX_POLL_MODE_CONFIG-Enumeration gibt den Abfragemodus an.
NFC_CX_SEQUENCE Die NFC_CX_SEQUENCE-Enumeration gibt Sequenzen an.
NFC_CX_TRANSPORT_TYPE Die NFC_CX_TRANSPORT_TYPE-Enumeration gibt Transporttypen an.
SECURE_ELEMENT_CARD_EMULATION_MODE Diese Enumeration gibt den Karte Emulationsmodus eines sicheren Elements an.
SECURE_ELEMENT_EVENT_TYPE Gibt den Typ der Ereignisse für sichere Elemente an.
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE ist Mitglied von SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_TYPE Gibt den Typ eines sicheren Elements an.

Functions

EVT_NFC_CX_DEVICE_IO_CONTROL Wird vom NFC CX aufgerufen, um eine nicht behandelte IOCTL an den Clienttreiber zu senden.
EVT_NFC_CX_SEQUENCE_HANDLER Wird vom NFC CX aufgerufen, um den Clienttreiber zu benachrichtigen, die bestimmte registrierte Sequenz zu verarbeiten.
EVT_NFC_CX_WRITE_NCI_PACKET Wird vom NFC CX aufgerufen, um ein Schreibpaket an den Clienttreiber zu senden.
NFC_CX_CLIENT_CONFIG_INIT Die NFC_CX_CLIENT_CONFIG_INIT-Funktion initialisiert die NFC_CX_CLIENT_CONFIG-Struktur.
NFC_CX_LLCP_CONFIG_INIT Die NFC_CX_LLCP_CONFIG_INIT-Funktion initialisiert die NFC_CX_LLCP_CONFIG-Struktur.
NFC_CX_RF_DISCOVERY_CONFIG_INIT Die NFC_CX_RF_DISCOVERY_CONFIG_INIT-Funktion initialisiert die NFC_CX_RF_DISCOVERY_CONFIG-Struktur.
NfcCxDeviceDeinitialize Die NfcCxDeviceDeinitialize-Funktion (nfccx.h) deinitialisiert ein WDF-Gerät, das während der AddDevice-Routine erstellt wurde.
NfcCxDeviceInitConfig Wird vom Clienttreiber während seiner AddDevice-Routine aufgerufen, um DeviceInit-Funktionen auszuführen. Während dieses Vorgangs werden auch die folgenden E/A-Rückruffunktionen ausgetauscht.
NfcCxDeviceInitialize Die NfcCxDeviceInitialize-Funktion (nfccx.h) initialisiert ein WDF-Gerät, das während der AddDevice-Routine erstellt wurde.
NfcCxHardwareEvent Wird vom Clienttreiber aufgerufen, wenn ein Hardwareereignis wie D0Entry- und D0Exit-Rückrufe auftritt, um das Gerät zu starten oder zu beenden. Für Treiber, für die bei der Initialisierung oder beim Start firmwaredownload erforderlich ist, wird empfohlen, diesen Aufruf in ein separates Arbeitselement zu verschieben. Der Clienttreiber ist jedoch für Folgendes verantwortlich.
NfcCxNciReadNotification Wird vom Clienttreiber aufgerufen, wenn ein Lesepaket verfügbar ist.
NfcCxRegisterSequenceHandler Wird vom Clienttreiber während der Initialisierung aufgerufen, um sich für die Behandlung bestimmter Sequenzen zu registrieren.
NfcCxSetLlcpConfig Wird vom Clienttreiber aufgerufen, um die LLCP-Parameter zu konfigurieren.
NfcCxSetRfDiscoveryConfig Wird vom Clienttreiber aufgerufen, um die RF-Ermittlungsparameter zu konfigurieren.
NfcCxUnregisterSequenceHandler Wird vom Clienttreiber während des Herunterfahrens des Geräts aufgerufen, um die Registrierung für den zuvor registrierten Sequenzhandlerrückruf aufzuheben.

Strukturen

NFC_CX_CLIENT_CONFIG Die NFC_CX_CLIENT_CONFIG-Struktur ist ein Eingabeparameter für NfcCxDeviceInitConfig.
NFC_CX_HARDWARE_EVENT Die NFC_CX_HARDWARE_EVENT-Struktur ist ein Eingabeparameter für NfcCxHardwareEvent.
NFC_CX_LLCP_CONFIG Die NFC_CX_LLCP_CONFIG-Struktur ist ein Eingabeparameter für NfcCxSetLlcpConfig.
NFC_CX_RF_DISCOVERY_CONFIG Die NFC_CX_RF_DISCOVERY_CONFIG-Struktur enthält Konfigurationseinstellungen für die RF-Ermittlung. Die Ermittlungskonfiguration sollte während der Initialisierung nach dem Aufruf von NfcDxDeviceInitialize abgeschlossen werden, andernfalls wird ein Fehler zurückgegeben.
NFCCX_DRIVER_GLOBALS Die _NFCCX_DRIVER_GLOBALS-Struktur enthält globale Werte für den NFC-CX-Treiber (Near Field Communications).
NFCRM_RADIO_STATE Diese Struktur wird verwendet, um den Funkzustand anzugeben.
NFCRM_SET_RADIO_STATE Diese Struktur wird verwendet, um den Funkzustand festzulegen. Der Fahrer muss im Fall des Flugzeugmodus den Funkzustand beibehalten und wiederherstellen, wenn der Flugzeugmodus deaktiviert ist.
SCARD_IO_REQUEST Diese Struktur wird verwendet, um eine E/A-Anforderung für intelligente Karte zu identifizieren.
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO ist Mitglied von SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO ist Mitglied von SECURE_ELEMENT_ENDPOINT_LIST.
SECURE_ELEMENT_ENDPOINT_LIST Der Ausgabeparameter für IOCTL_NFCSE_ENUM_ENDPOINTS.
SECURE_ELEMENT_EVENT_INFO Diese Struktur stellt Informationen zu einem ereignissicheren Element bereit.
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO Die SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO-Struktur ist ein Eingabeparameter, der IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT werden soll.
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD Die _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD-Struktur enthält eine eindeutige Verbindungs-ID und NFC Forum RF-Technologie und Protokolltypen.
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET ist ein Eingabepuffer zum IOCTL_NFCSE_HCE_REMOTE_SEND und ausgabepuffer für IOCTL_NFCSE_HCE_REMOTE_RECV.
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES enthält NFC-Controllerfunktionen.
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO ist Mitglied von SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE ist ein Eingabeparameter für IOCTL_NFCSE_SET_ROUTING_TABLE.
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY ist Mitglied von SECURE_ELEMENT_ROUTING_TABLE.
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO ist der Eingabeparameter für IOCTL_NFCSE_SET_CARD_EMULATION_MODE.
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO ist Mitglied von SECURE_ELEMENT_ROUTING_TABLE_ENTRY.