Near Field Communications (NFC)
Übersicht über die Near Field Communications (NFC)-Technologie.
Um Near Field Communications (NFC) zu entwickeln, benötigen Sie die folgenden Header:
Die Programmieranleitung 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 Funkstromzustand des Näherungsgeräts abzufragen. |
IOCTL_NFCRM_SET_RADIO_STATE Diese IOCTL wird von der Funkverwaltungsanwendung oder dem Dienst verwendet, um den Funkstromzustand des Näherungsgeräts festzulegen. |
IOCTL_NFCSE_ENUM_ENDPOINTS Gibt Informationen zur Liste aller sicheren Elemente zurück, die mit dem NFC-Controller verbunden 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 weiteren gepufferten Ereignisse ausstehen, 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 Steuercode gibt Informationen zu den aktuellen NFC-Controllerfunktionen zurück, einschließlich der maximalen Tabellengröße des Listenmodus routing (definiert in Abschnitt 4.2 der technischen Spezifikation NCI (NFC Controller Interface, Version 1.1) und unterstützter 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 mehr gepufferten Daten vorhanden sind, bleibt die Anforderung aus, bis ein APDU-Puffer zum Lesen verfügbar ist. |
IOCTL_NFCSE_HCE_REMOTE_SEND Überträgt Antwort-APDU von DeviceHost NFCEE an Remotegerät. Der Aufrufer muss sicherstellen, dass die Antwort-APDU mit ISO-IEC 7816-4 konform ist. |
IOCTL_NFCSE_SET_CARD_EMULATION_MODE Der IOCTL_NFCSE_SET_CARD_EMULATION_MODE Steuerelementcode legt fest, ob das angegebene sichere Element im Kartenemulationsmodus verfügbar gemacht wird. |
IOCTL_NFCSE_SET_ROUTING_TABLE Konfiguriert die Routingtabelle für den NFC-Controller-Listenmodus. |
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Der IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Steuerelementcode wird von einem Client ausgegeben, um ein bestimmtes Ereignis zu abonnieren. |
IOCTL_NFCSERM_QUERY_RADIO_STATE Die IOCTL_NFCSERM_QUERY_RADIO_STATE wird von der SE-Funkverwaltungsanwendung oder dem SE-Dienst verwendet, um den aktuellen Funkstromzustand des Näherungsgeräts abzufragen. |
IOCTL_NFCSERM_SET_RADIO_STATE Die IOCTL_NFCSERM_SET_RADIO_STATE wird von der SE-Funkverwaltungsanwendung oder -dienst verwendet, um den aktuellen Funkstromzustand des Näherungsgeräts festzulegen. |
IOCTL_NFP_DISABLE Ein Client sendet die IOCTL_NFP_DISABLE Anforderung, Abonnements, Publikationen und Anwesenheitsereignisse vorübergehend zu deaktivieren. |
IOCTL_NFP_ENABLE Der Client sendet die IOCTL_NFP_ENABLE Anforderung, zuvor deaktivierte Abonnements, Publikationen 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 generisches Handle, eines, 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 allgemeines Handle, eines, das nicht veröffentlicht und nicht abonniert ist, an das Anbietergerät, um die maximale Nachrichtengröße zu ermitteln, die unterstützt wird. |
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Der Client sendet die IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Anforderung wiederholt an das Abonnementhandle, um abonnierte Nachrichten zu empfangen, sobald sie eingehen. |
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Ein Client, der an Benachrichtigungen interessiert ist, 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 Der IOCTL_SMARTCARD_GET_ATTRIBUTE Steuerelementcode fragt nach Smartcardattributen ab. |
IOCTL_SMARTCARD_GET_STATE Der IOCTL_SMARTCARD_GET_STATE-Steuerelementcode ruft den aktuellen Status der Smartcard ab. |
IOCTL_SMARTCARD_IS_ABSENT Der IOCTL_SMARTCARD_IS_ABSENT-Steuerelementcode wird sofort mit STATUS_SUCCESS zurückgegeben, wenn derzeit keine Smartcard erkannt wird. |
IOCTL_SMARTCARD_IS_PRESENT Der IOCTL_SMARTCARD_IS_PRESENT-Steuerelementcode erkennt, ob derzeit eine Smartcard erkannt wird. |
IOCTL_SMARTCARD_POWER Windows erfordert möglicherweise einen Treiber, dass dieser IOCTL NOP sein und erfolglos ist. |
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 Procotol fest, mit dem der Treiber mit der Smartcard kommuniziert, nachdem die Karte erkannt wurde. |
IOCTL_SMARTCARD_TRANSMIT Überträgt Daten vom Client an die erkannte Smartcard in ISO7816-4-kompatiblen APDU. |
Aufzählungen
NFC_CX_CE_MODE_CONFIG Diese Enumeration gibt CE-Überwachungsmoduskennzeichnungen an. |
NFC_CX_DEVICE_MODE Gibt Gerätemoduskennzeichnungen an. |
NFC_CX_DRIVER_FLAGS Gibt Laufzeittreiberkennzeichnungen an. |
NFC_CX_HOST_ACTION Die NFC_CX_HOST_ACTION-Aufzählung gibt Hostaktionen an. |
NFC_CX_NFCIP_MODE_CONFIG Die NFC_CX_NFCIP_MODE_CONFIG-Aufzählung gibt den NFC-IP Initiatormodus an. |
NFC_CX_NFCIP_TGT_MODE_CONFIG Die NFC_CX_NFCIP_TGT_MODE_CONFIG-Aufzählung gibt NFC-IP Zielmodus an. |
NFC_CX_POLL_BAILOUT_CONFIG Die NFC_CX_POLL_BAILOUT_CONFIG-Aufzählung gibt das Abrufen des Abrufmodus an. |
NFC_CX_POLL_MODE_CONFIG Die NFC_CX_POLL_MODE_CONFIG-Aufzählung gibt den Abrufmodus an. |
NFC_CX_SEQUENCE Die NFC_CX_SEQUENCE-Aufzählung gibt Sequenzen an. |
NFC_CX_TRANSPORT_TYPE Die NFC_CX_TRANSPORT_TYPE-Aufzählung gibt Transporttypen an. |
SECURE_ELEMENT_CARD_EMULATION_MODE Diese Aufzählung gibt den Kartenemulationsmodus 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. |
Funktionen
EVT_NFC_CX_DEVICE_IO_CONTROL Vom NFC CX aufgerufen, um einen unbehandelten IOCTL an den Clienttreiber zu senden. |
EVT_NFC_CX_SEQUENCE_HANDLER Wird vom NFC CX aufgerufen, um den Clienttreiber über die Verarbeitung der spezifischen registrierten Sequenz zu benachrichtigen. |
EVT_NFC_CX_WRITE_NCI_PACKET 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 während der AddDevice-Routine vom Clienttreiber aufgerufen, um DeviceInit-Funktionen auszuführen. Während dieses Prozesses 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 auftritt, z. B. D0Entry- und D0Exit-Rückrufe, um das Gerät zu starten oder zu beenden. Für Treiber, die firmwarebasierte Downloads für Initialisierung oder Start erfordern, empfiehlt es sich, diesen Aufruf in eine separate Arbeitsaufgabe 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- Vom Clienttreiber aufgerufen, um die LLCP-Parameter zu konfigurieren. |
NfcCxSetRfDiscoveryConfig- Vom Clienttreiber aufgerufen, um die RF-Ermittlungsparameter zu konfigurieren. |
NfcCxUnregisterSequenceHandler- Vom Clienttreiber beim Herunterfahren 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 RF-Ermittlungskonfigurationseinstellungen. Die Ermittlungskonfiguration sollte während der Initialisierung nach dem Aufrufen 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 NEAR Field Communications (NFC)-CX-Treiber. |
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 Falle des Flugzeugmodus den Funkzustand beibehalten und wiederhergestellt werden, wenn der Flugzeugmodus deaktiviert ist. |
SCARD_IO_REQUEST Diese Struktur wird verwendet, um eine Smartcard-E/A-Anforderung 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 sicheren Elementereignis bereit. |
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO Die SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO-Struktur ist ein Eingabeparameter zum IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT. |
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD Die _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD-Struktur enthält einen eindeutigen Verbindungsbezeichner 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. |