Comunicazioni in campo vicino (NFC)
Panoramica della tecnologia Near field communications (NFC).
Per sviluppare comunicazioni sul campo vicino (NFC), sono necessarie queste intestazioni:
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 l'attribuitura 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 nell'API conforme a ISO7816-4. |
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. |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per