近距離現場通訊 (NFC)

近距離無線通訊 (NFC) 技術的概觀。

若要開發近域通訊 (NFC) ，您需要下列標頭：

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

如需程式設計指南，請參閱 近距離無線通訊 (NFC) 。

IOCTLs

IOCTL_NFCRM_QUERY_RADIO_STATE 無線電管理應用程式或服務會使用此 IOCTL 來查詢鄰近裝置目前的無線電電源狀態。
IOCTL_NFCRM_SET_RADIO_STATE 無線電管理應用程式或服務會使用此 IOCTL 來設定鄰近裝置的無線電電源狀態。
IOCTL_NFCSE_ENUM_ENDPOINTS 傳回附加至 NFC 控制器之所有安全元素清單的相關資訊。
IOCTL_NFCSE_GET_NEXT_EVENT IOCTL_NFCSE_GET_NEXT_EVENT控制項程式碼會傳回緩衝區中可用的下一個事件，或者，如果沒有其他緩衝的事件仍擱置中，直到有安全的元素事件可用為止。 事件詳細資料接著必須傳回給呼叫端。
IOCTL_NFCSE_GET_NFCC_CAPABILITIES IOCTL_NFCSE_GET_NFCC_CAPABILITIES控制程式代碼會傳回目前 NFC 控制器功能的相關資訊，包括 NFC 控制器介面第 4.2 節中定義的接聽模式路由表大小上限 (， (NCI) 技術規格 1.1 版) 和支援的路由模式。
IOCTL_NFCSE_GET_ROUTING_TABLE 傳回有關目前接聽模式路由表組態的資訊。
IOCTL_NFCSE_HCE_REMOTE_RECV 傳回可用的下一個資料緩衝區，如果沒有其他緩衝的資料，要求應該會保持擱置中，直到 APDU 緩衝區可供讀取為止。
IOCTL_NFCSE_HCE_REMOTE_SEND 將回應 APDU 從 DeviceHost NFCEE 傳輸至遠端裝置。 呼叫端必須確定回應 APDU 符合 ISO-IEC 7816-4。
IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL_NFCSE_SET_CARD_EMULATION_MODE控制項程式碼會設定指定的安全元素是否在卡片模擬模式中公開。
IOCTL_NFCSE_SET_ROUTING_TABLE 設定 NFC 控制器接聽模式路由表。
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT控制項程式碼是由用戶端發出，以訂閱特定事件。
IOCTL_NFCSERM_QUERY_RADIO_STATE SE 無線電管理應用程式或服務會使用IOCTL_NFCSERM_QUERY_RADIO_STATE來查詢鄰近裝置目前的無線電電源狀態。
IOCTL_NFCSERM_SET_RADIO_STATE SE 無線電管理應用程式或服務會使用IOCTL_NFCSERM_SET_RADIO_STATE來設定鄰近裝置目前的無線電電源狀態。
IOCTL_NFP_DISABLE 用戶端會傳送IOCTL_NFP_DISABLE要求，暫時停用訂閱、發行集和目前狀態事件。
IOCTL_NFP_ENABLE 用戶端會傳送IOCTL_NFP_ENABLE要求，以重新啟用先前停用的訂閱、發行集和目前狀態事件。
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND 用戶端會將IOCTL_NFP_GET_KILO_BYTES_PER_SECOND要求傳送至提供者裝置，也就是非已發佈和非訂閱的一般控制碼。
IOCTL_NFP_GET_MAX_MESSAGE_BYTES 用戶端會將IOCTL_NFP_GET_MAX_MESSAGE_BYTES要求傳送至任何一般控制碼，也就是非已發佈和非訂閱的控制碼，以判斷支援的訊息大小上限。
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE 用戶端會將IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE要求重複傳送至訂用帳戶控制碼，以便在收到訂閱訊息時接收。
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE 有興趣接收訊息傳輸通知的用戶端會將IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE要求傳送至鄰近驅動程式。
IOCTL_NFP_SET_PAYLOAD 用戶端應用程式會傳送訊息資料，並使用IOCTL_NFP_SET_PAYLOAD要求確認發行集。
IOCTL_SMARTCARD_GET_ATTRIBUTE IOCTL_SMARTCARD_GET_ATTRIBUTE控制項程式碼會查詢智慧卡工作。
IOCTL_SMARTCARD_GET_STATE IOCTL_SMARTCARD_GET_STATE控制項程式碼會取得智慧卡的目前狀態。
IOCTL_SMARTCARD_IS_ABSENT 如果目前未偵測到任何智慧卡，IOCTL_SMARTCARD_IS_ABSENT控制項程式碼會立即傳回STATUS_SUCCESS。
IOCTL_SMARTCARD_IS_PRESENT IOCTL_SMARTCARD_IS_PRESENT控制項程式碼會偵測目前是否偵測到智慧卡。
IOCTL_SMARTCARD_POWER Windows 可能需要讓此 IOCTL 成為 NOP 並傳回成功。
IOCTL_SMARTCARD_SET_ATTRIBUTE IOCTL_SMARTCARD_SET_ATTRIBUTE控制項程式碼會設定屬性，並在SCARD_ATTR_DEVICE_IN_USE上傳回STATUS_SUCCESS;否則會傳回STATUS_NOT_SUPPORTED。
IOCTL_SMARTCARD_SET_PROTOCOL 設定驅動程式在偵測到卡片之後與智慧卡通訊的 Procotol。
IOCTL_SMARTCARD_TRANSMIT 在符合 ISO7816-4 規範的 APDU 中，將資料從用戶端傳輸到偵測到的智慧卡。

列舉

NFC_CX_CE_MODE_CONFIG 這個列舉會指定 CE 接聽模式旗標。
NFC_CX_DEVICE_MODE 指定裝置模式旗標。
NFC_CX_DRIVER_FLAGS 指定執行時間驅動程式旗標。
NFC_CX_HOST_ACTION NFC_CX_HOST_ACTION列舉會指定主機動作。
NFC_CX_NFCIP_MODE_CONFIG NFC_CX_NFCIP_MODE_CONFIG列舉會指定 NFC-IP 啟動器模式。
NFC_CX_NFCIP_TGT_MODE_CONFIG NFC_CX_NFCIP_TGT_MODE_CONFIG列舉會指定 NFC-IP 目標模式。
NFC_CX_POLL_BAILOUT_CONFIG NFC_CX_POLL_BAILOUT_CONFIG列舉會指定輪詢模式釋出。
NFC_CX_POLL_MODE_CONFIG NFC_CX_POLL_MODE_CONFIG列舉會指定輪詢模式。
NFC_CX_SEQUENCE NFC_CX_SEQUENCE列舉會指定序列。
NFC_CX_TRANSPORT_TYPE NFC_CX_TRANSPORT_TYPE列舉會指定傳輸類型。
SECURE_ELEMENT_CARD_EMULATION_MODE 這個列舉表示安全元素的卡片模擬模式。
SECURE_ELEMENT_EVENT_TYPE 指出安全專案事件的型別。
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE是 SECURE_ELEMENT_ROUTING_TABLE_ENTRY 的成員。
SECURE_ELEMENT_TYPE 表示安全專案的型別。

函式

EVT_NFC_CX_DEVICE_IO_CONTROL 由 NFC CX 呼叫，以將未處理的 IOCTL 傳送給用戶端驅動程式。
EVT_NFC_CX_SEQUENCE_HANDLER 由 NFC CX 呼叫，以通知用戶端驅動程式以處理特定的已註冊序列。
EVT_NFC_CX_WRITE_NCI_PACKET 由 NFC CX 呼叫，以將寫入封包傳送至用戶端驅動程式。
NFC_CX_CLIENT_CONFIG_INIT NFC_CX_CLIENT_CONFIG_INIT函式會初始化NFC_CX_CLIENT_CONFIG結構。
NFC_CX_LLCP_CONFIG_INIT NFC_CX_LLCP_CONFIG_INIT函式會初始化 NFC_CX_LLCP_CONFIG 結構。
NFC_CX_RF_DISCOVERY_CONFIG_INIT NFC_CX_RF_DISCOVERY_CONFIG_INIT函式會初始化 NFC_CX_RF_DISCOVERY_CONFIG 結構。
NfcCxDeviceDeinitialize NfcCxDeviceDeinitialize 函式 (nfccx.h) deinitializes 在 AddDevice 常式期間建立的 WDF 裝置。
NfcCxDeviceInitConfig 用戶端驅動程式在其 AddDevice 常式期間呼叫以執行 DeviceInit 函式。 在此程式中，也會交換下列 I/O 回呼函式。
NfcCxDeviceInitialize NfcCxDeviceInitialize 函式 (nfccx.h) 初始化 AddDevice 常式期間建立的 WDF 裝置。
NfcCxHardwareEvent 當硬體事件發生時，用戶端驅動程式會呼叫，例如 D0Entry 和 D0Exit 回呼來啟動或停止裝置。 對於在初始化或開機時需要韌體下載的驅動程式，建議將此呼叫移至個別的工作專案。 不過，用戶端驅動程式負責下列事項。
NfcCxNciReadNotification 當讀取封包可供使用時，由用戶端驅動程式呼叫。
NfcCxRegisterSequenceHandler 在初始化期間由用戶端驅動程式呼叫，以註冊以處理特定序列。
NfcCxSetLlcpConfig 由用戶端驅動程式呼叫以設定 LLCP 參數。
NfcCxSetRfDiscoveryConfig 由用戶端驅動程式呼叫以設定 RF 探索參數。
NfcCxUnregisterSequenceHandler 在裝置關機期間由用戶端驅動程式呼叫，以取消註冊先前註冊的序列處理常式回呼。

結構

NFC_CX_CLIENT_CONFIG NFC_CX_CLIENT_CONFIG 結構是 NfcCxDeviceInitConfig 的輸入參數。
NFC_CX_HARDWARE_EVENT NFC_CX_HARDWARE_EVENT 結構是 NfcCxHardwareEvent 的輸入參數。
NFC_CX_LLCP_CONFIG NFC_CX_LLCP_CONFIG 結構是 NfcCxSetLlcpConfig 的輸入參數。
NFC_CX_RF_DISCOVERY_CONFIG NFC_CX_RF_DISCOVERY_CONFIG 結構包含 RF 探索組態設定。 呼叫 NfcDxDeviceInitialize 之後，應該在初始化期間完成探索設定，否則會傳回錯誤。
NFCCX_DRIVER_GLOBALS _NFCCX_DRIVER_GLOBALS 結構包含近域通訊 (NFC) CX 驅動程式的全域值。
NFCRM_RADIO_STATE 這個結構用來表示無線電狀態。
NFCRM_SET_RADIO_STATE 這個結構是用來設定無線電狀態。 在飛機模式的情況下，驅動程式必須保存無線電狀態，並在停用飛機模式時加以還原。
SCARD_IO_REQUEST 這個結構可用來識別智慧卡 I/O 要求。
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO是 SECURE_ELEMENT_ROUTING_TABLE_ENTRY 的成員。
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO是 SECURE_ELEMENT_ENDPOINT_LIST 的成員。
SECURE_ELEMENT_ENDPOINT_LIST IOCTL_NFCSE_ENUM_ENDPOINTS的輸出參數。
SECURE_ELEMENT_EVENT_INFO 這個結構提供安全專案事件的相關資訊。
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO 結構是IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT的輸入參數。
SECURE_ELEMENT_HCE_ACTI加值稅ION_PAYLOAD _SECURE_ELEMENT_HCE_ACTI加值稅ION_PAYLOAD結構包含唯一的連線識別碼和 NFC 論壇 RF 技術和通訊協定類型。
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET是輸入緩衝區，可IOCTL_NFCSE_HCE_REMOTE_SEND IOCTL_NFCSE_HCE_REMOTE_RECV輸出緩衝區。
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES包含 NFC 控制器功能。
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO是 SECURE_ELEMENT_ROUTING_TABLE_ENTRY 的成員。
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE是IOCTL_NFCSE_SET_ROUTING_TABLE的輸入參數。
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY是 SECURE_ELEMENT_ROUTING_TABLE 的成員。
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO是IOCTL_NFCSE_SET_CARD_EMULATION_MODE的輸入參數。
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO是SECURE_ELEMENT_ROUTING_TABLE_ENTRY的成員。