Близкое к полю связь (NFC)
Обзор технологии связи поблизости (NFC).
Для разработки связи с полями (NFC) вам потребуются следующие заголовки:
Руководство по программированию см. в связи с полями (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, включая максимальный размер таблицы маршрутизации в режиме прослушивания (определенный в разделе 4.2 интерфейса контроллера NFC (NCI) Technical Specification Version 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 IOCTL_NFCSERM_QUERY_RADIO_STATE используется приложением или службой управления радиосвязями SE для запроса текущего состояния радиосвязи устройства близкого взаимодействия. |
|
IOCTL_NFCSERM_SET_RADIO_STATE IOCTL_NFCSERM_SET_RADIO_STATE используется приложением или службой управления радиосвязями SE, чтобы задать текущее состояние питания радио устройства близкого взаимодействия. |
|
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 задает атрибут и возвращает STATUS_SUCCESS на SCARD_ATTR_DEVICE_IN_USE; в противном случае возвращается STATUS_NOT_SUPPORTED. |
|
IOCTL_SMARTCARD_SET_PROTOCOL Задает прокотол, с которым драйвер взаимодействует с смарт-картой после обнаружения карты. |
|
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) деинициализирует устройство WDF, созданное во время процедуры AddDevice. |
|
NfcCxDeviceInitConfig Вызывается драйвером клиента во время подпрограммы AddDevice для выполнения функций DeviceInit. Во время этого процесса также обмениваются следующими функциями обратного вызова ввода-вывода. |
|
NfcCxDeviceInitialize Функция NfcCxDeviceInitialize (nfccx.h) инициализирует устройство WDF, созданное во время подпрограммы AddDevice. |
|
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 содержит глобальные значения для драйвера CX близкого поля связи (NFC). |
|
NFCRM_RADIO_STATE Эта структура используется для указания состояния радиосвязи. |
|
NFCRM_SET_RADIO_STATE Эта структура используется для задания состояния радио. Водитель, в случае с режимом самолета, должен сохранить состояние радио и восстановить его при отключении режима самолета. |
|
SCARD_IO_REQUEST Эта структура используется для идентификации запроса ввода-вывода смарт-карты. |
|
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_ACTIVATION_PAYLOAD Структура _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD содержит уникальный идентификатор подключения и типы технологий и протоколов NFC Forum 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. |