Comunicaciones de campo cercano (NFC)

Información general sobre la tecnología de comunicaciones de campo cercano (NFC).

Para desarrollar comunicaciones de campo cercano (NFC), necesita estos encabezados:

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

Para obtener la guía de programación, consulte Comunicaciones de campo cercano (NFC).

IOCTL

IOCTL_NFCRM_QUERY_RADIO_STATE Esta IOCTL la usa la aplicación de administración de radio o el servicio para consultar el estado actual de la energía de radio del dispositivo de proximidad.
IOCTL_NFCRM_SET_RADIO_STATE Esta IOCTL la utiliza la aplicación de administración de radio o el servicio para establecer el estado de alimentación de radio del dispositivo de proximidad.
IOCTL_NFCSE_ENUM_ENDPOINTS Devuelve información relativa a la lista de todos los elementos seguros adjuntos al controlador NFC.
IOCTL_NFCSE_GET_NEXT_EVENT El código de control IOCTL_NFCSE_GET_NEXT_EVENT devuelve el siguiente evento disponible en el búfer o si no hay más eventos almacenados en búfer permanece pendiente hasta que haya disponible un evento de elemento seguro. A continuación, los detalles del evento se deben devolver al autor de la llamada.
IOCTL_NFCSE_GET_NFCC_CAPABILITIES El código de control IOCTL_NFCSE_GET_NFCC_CAPABILITIES devuelve información sobre las funcionalidades actuales del controlador NFC, incluido el tamaño máximo de la tabla de enrutamiento del modo de escucha (definido en la sección 4.2 de la especificación técnica de la interfaz de controlador NFC (NCI) versión 1.1) y los modos de enrutamiento admitidos.
IOCTL_NFCSE_GET_ROUTING_TABLE Devuelve información relacionada con la configuración actual de la tabla de enrutamiento del modo de escucha.
IOCTL_NFCSE_HCE_REMOTE_RECV Devuelve el siguiente búfer de datos disponible o, si no hay más datos almacenados en búfer, la solicitud permanecerá pendiente hasta que haya un búfer APDU disponible para su lectura.
IOCTL_NFCSE_HCE_REMOTE_SEND Transmite apDU de respuesta de DeviceHost NFCEE al dispositivo remoto. El autor de la llamada debe asegurarse de que la RESPUESTA APDU es compatible con ISO-IEC 7816-4.
IOCTL_NFCSE_SET_CARD_EMULATION_MODE El código de control IOCTL_NFCSE_SET_CARD_EMULATION_MODE establece si el elemento seguro especificado se expone en modo de emulación de tarjeta.
IOCTL_NFCSE_SET_ROUTING_TABLE Configura la tabla de enrutamiento del modo de escucha del controlador NFC.
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Un cliente emite el código de control IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT para suscribirse a un evento específico.
IOCTL_NFCSERM_QUERY_RADIO_STATE El IOCTL_NFCSERM_QUERY_RADIO_STATE lo usa la aplicación o el servicio de administración de radios SE para consultar el estado actual de la energía de radio del dispositivo de proximidad.
IOCTL_NFCSERM_SET_RADIO_STATE El IOCTL_NFCSERM_SET_RADIO_STATE lo usa la aplicación de administración de radios o el servicio SE para establecer el estado de alimentación de radio actual del dispositivo de proximidad.
IOCTL_NFP_DISABLE Un cliente envía la solicitud de IOCTL_NFP_DISABLE para deshabilitar temporalmente las suscripciones, publicaciones y eventos de presencia.
IOCTL_NFP_ENABLE El cliente envía la solicitud de IOCTL_NFP_ENABLE para volver a habilitar las suscripciones, publicaciones y eventos de presencia deshabilitados previamente.
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Un cliente envía la solicitud de IOCTL_NFP_GET_KILO_BYTES_PER_SECOND a cualquier identificador genérico, uno que no está publicado y no suscrito, al dispositivo del proveedor.
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Un cliente envía la solicitud de IOCTL_NFP_GET_MAX_MESSAGE_BYTES a cualquier identificador genérico, uno que no está publicado y no suscrito, al dispositivo proveedor para determinar el tamaño máximo de mensaje admitido.
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE El cliente envía la solicitud de IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE al identificador de suscripción repetidamente para recibir mensajes suscritos a medida que llegan.
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Un cliente interesado en recibir notificaciones que se ha transmitido un mensaje enviará la solicitud de IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE al controlador de proximidad.
IOCTL_NFP_SET_PAYLOAD Una aplicación cliente envía datos de mensajes y confirma la publicación con la solicitud de IOCTL_NFP_SET_PAYLOAD.
IOCTL_SMARTCARD_GET_ATTRIBUTE El código de control IOCTL_SMARTCARD_GET_ATTRIBUTE consulta los atributos de tarjeta inteligente.
IOCTL_SMARTCARD_GET_STATE El código de control IOCTL_SMARTCARD_GET_STATE obtiene el estado actual de la tarjeta inteligente.
IOCTL_SMARTCARD_IS_ABSENT El código de control IOCTL_SMARTCARD_IS_ABSENT devuelve inmediatamente con STATUS_SUCCESS si no se detecta ninguna tarjeta inteligente actualmente.
IOCTL_SMARTCARD_IS_PRESENT El código de control IOCTL_SMARTCARD_IS_PRESENT detecta si actualmente se detecta una tarjeta inteligente.
IOCTL_SMARTCARD_POWER Windows puede requerir que un controlador tenga este IOCTL como NOP y devuelva el éxito.
IOCTL_SMARTCARD_SET_ATTRIBUTE El código de control IOCTL_SMARTCARD_SET_ATTRIBUTE establece un atributo y devuelve STATUS_SUCCESS en SCARD_ATTR_DEVICE_IN_USE; de lo contrario, devuelve STATUS_NOT_SUPPORTED.
IOCTL_SMARTCARD_SET_PROTOCOL Establece el procotol con el que se comunica el controlador con la tarjeta inteligente después de detectar la tarjeta.
IOCTL_SMARTCARD_TRANSMIT Transmite datos del cliente a la tarjeta inteligente detectada en ISO7816-4 APDU compatible.

Enumeraciones

NFC_CX_CE_MODE_CONFIG Esta enumeración especifica las marcas del modo de escucha ce.
NFC_CX_DEVICE_MODE Especifica marcas de modo de dispositivo.
NFC_CX_DRIVER_FLAGS Especifica marcas de controlador en tiempo de ejecución.
NFC_CX_HOST_ACTION La enumeración NFC_CX_HOST_ACTION especifica las acciones de host.
NFC_CX_NFCIP_MODE_CONFIG La enumeración NFC_CX_NFCIP_MODE_CONFIG especifica el modo iniciador NFC-IP.
NFC_CX_NFCIP_TGT_MODE_CONFIG La enumeración NFC_CX_NFCIP_TGT_MODE_CONFIG especifica el modo de destino NFC-IP.
NFC_CX_POLL_BAILOUT_CONFIG La enumeración NFC_CX_POLL_BAILOUT_CONFIG especifica el rescate en modo de sondeo.
NFC_CX_POLL_MODE_CONFIG La enumeración NFC_CX_POLL_MODE_CONFIG especifica el modo de sondeo.
NFC_CX_SEQUENCE La enumeración NFC_CX_SEQUENCE especifica secuencias.
NFC_CX_TRANSPORT_TYPE La enumeración NFC_CX_TRANSPORT_TYPE especifica los tipos de transporte.
SECURE_ELEMENT_CARD_EMULATION_MODE Esta enumeración indica el modo de emulación de tarjeta de un elemento seguro.
SECURE_ELEMENT_EVENT_TYPE Indica el tipo de eventos de elemento seguro.
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE es miembro de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_TYPE Indica el tipo de un elemento seguro.

Functions

EVT_NFC_CX_DEVICE_IO_CONTROL Llamado por NFC CX para enviar un IOCTL no controlado al controlador de cliente.
EVT_NFC_CX_SEQUENCE_HANDLER Llamado por NFC CX para notificar al controlador cliente que controle la secuencia registrada específica.
EVT_NFC_CX_WRITE_NCI_PACKET Llamado por NFC CX para enviar un paquete de escritura al controlador cliente.
NFC_CX_CLIENT_CONFIG_INIT La función NFC_CX_CLIENT_CONFIG_INIT inicializa la estructura NFC_CX_CLIENT_CONFIG.
NFC_CX_LLCP_CONFIG_INIT La función NFC_CX_LLCP_CONFIG_INIT inicializa la estructura NFC_CX_LLCP_CONFIG.
NFC_CX_RF_DISCOVERY_CONFIG_INIT La función NFC_CX_RF_DISCOVERY_CONFIG_INIT inicializa la estructura NFC_CX_RF_DISCOVERY_CONFIG.
NfcCxDeviceDeinitialize La función NfcCxDeviceDeinitialize (nfccx.h) deinicializa un dispositivo WDF que se creó durante la rutina AddDevice.
NfcCxDeviceInitConfig Lo llama el controlador de cliente durante su rutina AddDevice para realizar funciones deviceInit. Durante este proceso también se intercambian las siguientes funciones de devolución de llamada de E/S.
NfcCxDeviceInitialize La función NfcCxDeviceInitialize (nfccx.h) inicializa un dispositivo WDF que se creó durante la rutina AddDevice.
NfcCxHardwareEvent Lo llama el controlador de cliente cuando se produce un evento de hardware como las devoluciones de llamada D0Entry y D0Exit para iniciar o detener el dispositivo. Para los controladores que requieren descarga de firmware en la inicialización o el arranque, se recomienda mover esta llamada a un elemento de trabajo independiente. Sin embargo, el controlador de cliente es responsable de lo siguiente.
NfcCxNciReadNotification Lo llama el controlador cliente cuando hay disponible un paquete de lectura.
NfcCxRegisterSequenceHandler Lo llama el controlador de cliente durante la inicialización para registrarse para controlar secuencias específicas.
NfcCxSetLlcpConfig Llamado por el controlador de cliente para configurar los parámetros LLCP.
NfcCxSetRfDiscoveryConfig Lo llama el controlador de cliente para configurar los parámetros de detección de RF.
NfcCxUnregisterSequenceHandler Lo llama el controlador cliente durante el apagado del dispositivo para anular el registro de la devolución de llamada del controlador de secuencia registrada anteriormente.

Estructuras

NFC_CX_CLIENT_CONFIG La estructura NFC_CX_CLIENT_CONFIG es un parámetro de entrada para NfcCxDeviceInitConfig.
NFC_CX_HARDWARE_EVENT La estructura NFC_CX_HARDWARE_EVENT es un parámetro de entrada para NfcCxHardwareEvent.
NFC_CX_LLCP_CONFIG La estructura NFC_CX_LLCP_CONFIG es un parámetro de entrada para NfcCxSetLlcpConfig.
NFC_CX_RF_DISCOVERY_CONFIG La estructura de NFC_CX_RF_DISCOVERY_CONFIG contiene los valores de configuración de detección de RF. La configuración de detección debe completarse durante la inicialización después de llamar a NfcDxDeviceInitialize; de lo contrario, se devuelve un error.
NFCCX_DRIVER_GLOBALS La estructura de _NFCCX_DRIVER_GLOBALS contiene valores globales para el controlador NEAR Field Communications (NFC) CX.
NFCRM_RADIO_STATE Esta estructura se usa para indicar el estado de radio.
NFCRM_SET_RADIO_STATE Esta estructura se usa para establecer el estado de radio. El conductor, en el caso del modo avión, tiene que conservar el estado de radio y restaurarlo cuando el modo avión está deshabilitado.
SCARD_IO_REQUEST Esta estructura se usa para identificar una solicitud de E/S de tarjeta inteligente.
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO es miembro de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO es miembro de SECURE_ELEMENT_ENDPOINT_LIST.
SECURE_ELEMENT_ENDPOINT_LIST Parámetro de salida para IOCTL_NFCSE_ENUM_ENDPOINTS.
SECURE_ELEMENT_EVENT_INFO Esta estructura proporciona información sobre un evento de elemento seguro.
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO La estructura SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO es un parámetro de entrada para IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT.
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD La estructura de _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD contiene un identificador de conexión único y tipos de protocolo y tecnología rf del foro NFC.
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET es un búfer de entrada para IOCTL_NFCSE_HCE_REMOTE_SEND y búfer de salida para IOCTL_NFCSE_HCE_REMOTE_RECV.
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES contiene funcionalidades del controlador NFC.
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO es miembro de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE es un parámetro de entrada para IOCTL_NFCSE_SET_ROUTING_TABLE.
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY es miembro de SECURE_ELEMENT_ROUTING_TABLE.
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO es el parámetro de entrada para IOCTL_NFCSE_SET_CARD_EMULATION_MODE.
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO es miembro de SECURE_ELEMENT_ROUTING_TABLE_ENTRY.