Comunicazioni sul campo vicino (NFC)
Panoramica della tecnologia NFC (Near Field Communications).
Per sviluppare near field communications (NFC), sono necessarie queste intestazioni:
- nfccx.h
- nfcradiodev.h
- nfcsedev.h
- nfpdev.h
- winsmcrd.h
Per la guida alla programmazione, vedere NFC (Near Field Communications).
IOCTLs
|
IOCTL_NFCRM_QUERY_RADIO_STATE Questo IOCTL viene usato dall'applicazione o dal servizio di gestione radio 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 altri eventi memorizzati nel buffer rimane in sospeso fino a quando 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à correnti del controller NFC, incluse le dimensioni massime della tabella routing in modalità di ascolto (definite nella sezione 4.2 della specifica tecnica NFC Controller Interface (NCI) versione 1.1) e le modalità di routing supportate. |
|
IOCTL_NFCSE_GET_ROUTING_TABLE Restituisce informazioni sulla configurazione corrente della tabella di routing in modalità di ascolto. |
|
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 sarà 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 assicurarsi che l'APDU della 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 protetto specificato viene esposto in modalità di emulazione della scheda. |
|
IOCTL_NFCSE_SET_ROUTING_TABLE Configura la tabella di routing in modalità di ascolto del controller NFC. |
|
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Il codice di controllo IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT viene emesso 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 una 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 ed eventi di presenza. |
|
IOCTL_NFP_ENABLE Il client invia la richiesta di IOCTL_NFP_ENABLE per riabilitare sottoscrizioni, pubblicazioni ed eventi di presenza precedentemente disabilitati. |
|
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 del provider. |
|
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Un client invia la richiesta di IOCTL_NFP_GET_MAX_MESSAGE_BYTES a qualsiasi handle generico, non pubblicato e non sottoscritto, al dispositivo del 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 i messaggi sottoscritti man mano che arrivano. |
|
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 Il codice di controllo IOCTL_SMARTCARD_GET_ATTRIBUTE query 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 una smart card è attualmente rilevata. |
|
IOCTL_SMARTCARD_POWER Windows potrebbe richiedere a un driver di avere questo IOCTL come 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 con cui il driver comunica con la smart card dopo che la scheda è stata rilevata. |
|
IOCTL_SMARTCARD_TRANSMIT Trasmette i dati dal client alla smart card rilevata nell ISO7816-4 APDU conforme. |
Enumerazioni
|
NFC_CX_CE_MODE_CONFIG Questa enumerazione specifica i flag della modalità di ascolto CE. |
|
NFC_CX_DEVICE_MODE Specifica i flag della modalità dispositivo. |
|
NFC_CX_DRIVER_FLAGS Specifica i flag del 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 NFC-IP modalità di destinazione. |
|
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 protetto. |
|
SECURE_ELEMENT_EVENT_TYPE Indica il tipo di eventi di 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 le funzioni DeviceInit. Durante questo processo vengono scambiate anche le funzioni di callback di I/O seguenti. |
|
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 I callback D0Entry e D0Exit per avviare o arrestare il dispositivo. Per i driver che richiedono il download del firmware durante l'inizializzazione o l'avvio, è consigliabile spostare questa chiamata a un elemento di lavoro separato. Tuttavia, il driver client è responsabile delle operazioni seguenti. |
|
nfcCxNciReadNotification Chiamato dal driver client quando è disponibile un pacchetto di lettura. |
|
NfcCxRegisterSequenceHandler Chiamato dal driver client durante l'inizializzazione per la registrazione 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 sequenza registrato in precedenza. |
Strutture
|
NFC_CX_CLIENT_CONFIG La struttura NFC_CX_CLIENT_CONFIG è un parametro di input per 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 per 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 la chiamata a 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 utilizzata per indicare lo stato di radio. |
|
NFCRM_SET_RADIO_STATE Questa struttura viene utilizzata per impostare lo stato di radio. Il conducente, nel caso della modalità aereo, deve rendere persistente 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. |