Comunicazioni in campo vicino (NFC)

Panoramica della tecnologia Near field communications (NFC).

Per sviluppare comunicazioni sul campo vicino (NFC), sono necessarie queste intestazioni:

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

Per la guida alla programmazione, vedere Near field communications (NFC).

IOCTL

IOCTL_NFCRM_QUERY_RADIO_STATE Questo IOCTL viene usato dall'applicazione di gestione radio o dal servizio per eseguire query sullo stato di alimentazione radio corrente del dispositivo di prossimità.
IOCTL_NFCRM_SET_RADIO_STATE Questo IOCTL viene usato dall'applicazione o dal servizio di gestione radio per impostare lo stato di alimentazione radio del dispositivo di prossimità.
IOCTL_NFCSE_ENUM_ENDPOINTS Restituisce informazioni relative all'elenco di tutti gli elementi sicuri collegati al controller NFC.
IOCTL_NFCSE_GET_NEXT_EVENT Il codice di controllo IOCTL_NFCSE_GET_NEXT_EVENT restituisce l'evento successivo disponibile nel buffer oppure se non sono presenti più eventi memorizzati nel buffer rimane in sospeso finché non è disponibile un evento di elemento sicuro. I dettagli dell'evento devono quindi essere restituiti al chiamante.
IOCTL_NFCSE_GET_NFCC_CAPABILITIES Il codice di controllo IOCTL_NFCSE_GET_NFCC_CAPABILITIES restituisce informazioni sulle funzionalità del controller NFC correnti, incluse le dimensioni massime della tabella di routing in modalità di ascolto (definite nella sezione 4.2 dell'interfaccia del controller NFC (NCI) e sulle modalità di routing supportate.
IOCTL_NFCSE_GET_ROUTING_TABLE Restituisce informazioni sulla configurazione corrente della tabella di routing in modalità listen.
IOCTL_NFCSE_HCE_REMOTE_RECV Restituisce il buffer di dati successivo disponibile o se non sono presenti più dati memorizzati nel buffer, la richiesta rimarrà in sospeso fino a quando non è disponibile un buffer APDU per la lettura.
IOCTL_NFCSE_HCE_REMOTE_SEND Trasmette l'APDU della risposta da DeviceHost NFCEE al dispositivo remoto. Il chiamante deve essere sicuro che l'APDU di risposta sia conforme a ISO-IEC 7816-4.
IOCTL_NFCSE_SET_CARD_EMULATION_MODE Il codice di controllo IOCTL_NFCSE_SET_CARD_EMULATION_MODE imposta se l'elemento sicuro specificato è esposto in modalità di emulazione della scheda.
IOCTL_NFCSE_SET_ROUTING_TABLE Configura la tabella di routing in modalità di routing in modalità di ascolto del controller NFC.
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Il codice di controllo IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT viene rilasciato da un client per sottoscrivere un evento specifico.
IOCTL_NFCSERM_QUERY_RADIO_STATE Il IOCTL_NFCSERM_QUERY_RADIO_STATE viene usato dall'applicazione o dal servizio di gestione radio SE per eseguire query sullo stato di alimentazione radio corrente del dispositivo di prossimità.
IOCTL_NFCSERM_SET_RADIO_STATE Il IOCTL_NFCSERM_SET_RADIO_STATE viene usato dall'applicazione o dal servizio di gestione radio SE per impostare lo stato di alimentazione radio corrente del dispositivo di prossimità.
IOCTL_NFP_DISABLE Un client invia la richiesta di IOCTL_NFP_DISABLE per disabilitare temporaneamente sottoscrizioni, pubblicazioni e eventi di presenza.
IOCTL_NFP_ENABLE Il client invia la richiesta di IOCTL_NFP_ENABLE per abilitare nuovamente le sottoscrizioni, le pubblicazioni e gli eventi di presenza disabilitati in precedenza.
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Un client invia la richiesta di IOCTL_NFP_GET_KILO_BYTES_PER_SECOND a qualsiasi handle generico, uno non pubblicato e non sottoscritto, al dispositivo provider.
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Un client invia la richiesta di IOCTL_NFP_GET_MAX_MESSAGE_BYTES a qualsiasi handle generico, uno non pubblicato e non sottoscritto, al dispositivo provider per determinare le dimensioni massime dei messaggi supportate.
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Il client invia ripetutamente la richiesta di IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE all'handle della sottoscrizione per ricevere messaggi sottoscritti durante l'arrivo.
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Un client interessato a ricevere notifiche che un messaggio è stato trasmesso invierà la richiesta di IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE al driver di prossimità.
IOCTL_NFP_SET_PAYLOAD Un'applicazione client invia i dati dei messaggi e conferma la pubblicazione con la richiesta di IOCTL_NFP_SET_PAYLOAD.
IOCTL_SMARTCARD_GET_ATTRIBUTE Query di codice di controllo IOCTL_SMARTCARD_GET_ATTRIBUTE per gli attributi della smart card.
IOCTL_SMARTCARD_GET_STATE Il codice di controllo IOCTL_SMARTCARD_GET_STATE ottiene lo stato corrente della smart card.
IOCTL_SMARTCARD_IS_ABSENT Il codice di controllo IOCTL_SMARTCARD_IS_ABSENT restituisce immediatamente con STATUS_SUCCESS se non viene rilevata alcuna smart card.
IOCTL_SMARTCARD_IS_PRESENT Il codice di controllo IOCTL_SMARTCARD_IS_PRESENT rileva se è attualmente rilevata una smart card.
IOCTL_SMARTCARD_POWER Windows potrebbe richiedere a un driver di avere questo IOCTL per essere NOP e restituire l'esito positivo.
IOCTL_SMARTCARD_SET_ATTRIBUTE Il codice di controllo IOCTL_SMARTCARD_SET_ATTRIBUTE imposta un attributo e restituisce STATUS_SUCCESS in SCARD_ATTR_DEVICE_IN_USE; in caso contrario, restituisce STATUS_NOT_SUPPORTED.
IOCTL_SMARTCARD_SET_PROTOCOL Imposta il procotol il driver comunica alla smart card con dopo che la scheda viene rilevata.
IOCTL_SMARTCARD_TRANSMIT Trasmette i dati dal client alla smart card rilevata in ISO7816-4 APDU conforme.

Enumerazioni

NFC_CX_CE_MODE_CONFIG Questa enumerazione specifica i flag di modalità di ascolto CE.
NFC_CX_DEVICE_MODE Specifica i flag della modalità dispositivo.
NFC_CX_DRIVER_FLAGS Specifica i flag di driver di runtime.
NFC_CX_HOST_ACTION L'enumerazione NFC_CX_HOST_ACTION specifica le azioni host.
NFC_CX_NFCIP_MODE_CONFIG L'enumerazione NFC_CX_NFCIP_MODE_CONFIG specifica la modalità iniziatore NFC-IP.
NFC_CX_NFCIP_TGT_MODE_CONFIG L'enumerazione NFC_CX_NFCIP_TGT_MODE_CONFIG specifica la modalità di destinazione NFC-IP.
NFC_CX_POLL_BAILOUT_CONFIG L'enumerazione NFC_CX_POLL_BAILOUT_CONFIG specifica il salvataggio in modalità polling.
NFC_CX_POLL_MODE_CONFIG L'enumerazione NFC_CX_POLL_MODE_CONFIG specifica la modalità di polling.
NFC_CX_SEQUENCE L'enumerazione NFC_CX_SEQUENCE specifica le sequenze.
NFC_CX_TRANSPORT_TYPE L'enumerazione NFC_CX_TRANSPORT_TYPE specifica i tipi di trasporto.
SECURE_ELEMENT_CARD_EMULATION_MODE Questa enumerazione indica la modalità di emulazione della scheda di un elemento sicuro.
SECURE_ELEMENT_EVENT_TYPE Indica il tipo di eventi dell'elemento sicuro.
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE è membro di SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_TYPE Indica il tipo di un elemento sicuro.

Funzioni

EVT_NFC_CX_DEVICE_IO_CONTROL Chiamato da NFC CX per inviare un IOCTL non gestito al driver client.
EVT_NFC_CX_SEQUENCE_HANDLER Chiamato da NFC CX per notificare al driver client di gestire la sequenza registrata specifica.
EVT_NFC_CX_WRITE_NCI_PACKET Chiamato da NFC CX per inviare un pacchetto di scrittura al driver client.
NFC_CX_CLIENT_CONFIG_INIT La funzione NFC_CX_CLIENT_CONFIG_INIT inizializza la struttura NFC_CX_CLIENT_CONFIG.
NFC_CX_LLCP_CONFIG_INIT La funzione NFC_CX_LLCP_CONFIG_INIT inizializza la struttura NFC_CX_LLCP_CONFIG.
NFC_CX_RF_DISCOVERY_CONFIG_INIT La funzione NFC_CX_RF_DISCOVERY_CONFIG_INIT inizializza la struttura NFC_CX_RF_DISCOVERY_CONFIG.
NfcCxDeviceDeinitialize La funzione NFCCxDeviceDeinitialize (nfccx.h) denitialize un dispositivo WDF creato durante la routine AddDevice.
NfcCxDeviceInitConfig Chiamato dal driver client durante la routine AddDevice per eseguire funzioni DeviceInit. Durante questo processo vengono scambiate anche le seguenti funzioni di callback di I/O.
NfcCxDeviceInitialize La funzione NfcCxDeviceInitialize (nfccx.h) inizializza un dispositivo WDF creato durante la routine AddDevice.
NfcCxHardwareEvent Chiamato dal driver client quando si verifica un evento hardware come D0Entry e D0Exit callback per avviare o arrestare il dispositivo. Per i driver che richiedono il download del firmware in fase di inizializzazione o avvio, è consigliabile spostare questa chiamata in un elemento di lavoro separato. Tuttavia, il driver client è responsabile per quanto segue.
NfcCxNciReadNotification Chiamato dal driver client quando è disponibile un pacchetto di lettura.
NfcCxRegisterSequenceHandler Chiamato dal driver client durante l'inizializzazione per registrare per la gestione di sequenze specifiche.
NfcCxSetLlcpConfig Chiamato dal driver client per configurare i parametri LLCP.
NfcCxSetRfDiscoveryConfig Chiamato dal driver client per configurare i parametri di individuazione RF.
NfcCxUnregisterSequenceHandler Chiamato dal driver client durante l'arresto del dispositivo per annullare la registrazione per il callback del gestore della sequenza registrato in precedenza.

Strutture

NFC_CX_CLIENT_CONFIG La struttura NFC_CX_CLIENT_CONFIG è un parametro di input in NfcCxDeviceInitConfig.
NFC_CX_HARDWARE_EVENT La struttura NFC_CX_HARDWARE_EVENT è un parametro di input per NfcCxHardwareEvent.
NFC_CX_LLCP_CONFIG La struttura NFC_CX_LLCP_CONFIG è un parametro di input in NfcCxSetLlcpConfig.
NFC_CX_RF_DISCOVERY_CONFIG La struttura NFC_CX_RF_DISCOVERY_CONFIG contiene le impostazioni di configurazione dell'individuazione RF. La configurazione di individuazione deve essere completata durante l'inizializzazione dopo aver chiamato NfcDxDeviceInitialize, in caso contrario viene restituito un errore.
NFCCX_DRIVER_GLOBALS La struttura _NFCCX_DRIVER_GLOBALS contiene valori globali per il driver CX Near Field Communications (NFC).
NFCRM_RADIO_STATE Questa struttura viene usata per indicare lo stato radio.
NFCRM_SET_RADIO_STATE Questa struttura viene usata per impostare lo stato di radio. Il conducente, nel caso della modalità aereo, deve mantenere lo stato radio e ripristinarlo quando la modalità aereo è disabilitata.
SCARD_IO_REQUEST Questa struttura viene usata per identificare una richiesta di I/O di smart card.
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO è membro di SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO è membro di SECURE_ELEMENT_ENDPOINT_LIST.
SECURE_ELEMENT_ENDPOINT_LIST Parametro di output per IOCTL_NFCSE_ENUM_ENDPOINTS.
SECURE_ELEMENT_EVENT_INFO Questa struttura fornisce informazioni su un evento di elemento sicuro.
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO La struttura SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO è un parametro di input da IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT.
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD La struttura _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD contiene un identificatore di connessione univoco e la tecnologia RF del Forum NFC e i tipi di protocollo.
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET è un buffer di input per IOCTL_NFCSE_HCE_REMOTE_SEND e buffer di output per IOCTL_NFCSE_HCE_REMOTE_RECV.
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES contiene funzionalità del controller NFC.
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO è membro di SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE è un parametro di input per IOCTL_NFCSE_SET_ROUTING_TABLE.
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY è membro di SECURE_ELEMENT_ROUTING_TABLE.
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO è il parametro di input per IOCTL_NFCSE_SET_CARD_EMULATION_MODE.
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO è membro di SECURE_ELEMENT_ROUTING_TABLE_ENTRY.