Comunicações de campo próximo (NFC)
Visão geral da tecnologia NFC (comunicações de campo próximo).
Para desenvolver NFC (comunicações de campo próximo), você precisa desses cabeçalhos:
- nfccx.h
- nfcradiodev.h
- nfcsedev.h
- nfpdev.h
- winsmcrd.h
Para obter o guia de programação, consulte NFC (Near field communications).
IOCTLs
|
IOCTL_NFCRM_QUERY_RADIO_STATE Esse IOCTL é usado pelo aplicativo ou serviço de gerenciamento de rádio para consultar o estado atual de energia de rádio do dispositivo de proximidade. |
|
IOCTL_NFCRM_SET_RADIO_STATE Esse IOCTL é usado pelo aplicativo ou serviço de gerenciamento de rádio para definir o estado de energia de rádio do dispositivo de proximidade. |
|
IOCTL_NFCSE_ENUM_ENDPOINTS Retorna informações sobre a lista de todos os elementos seguros anexados ao controlador NFC. |
|
IOCTL_NFCSE_GET_NEXT_EVENT O código de controle IOCTL_NFCSE_GET_NEXT_EVENT retorna o próximo evento disponível no buffer ou se não houver mais eventos em buffer pendentes até que um evento de elemento seguro esteja disponível. Em seguida, os detalhes do evento devem ser retornados ao chamador. |
|
IOCTL_NFCSE_GET_NFCC_CAPABILITIES O código de controle IOCTL_NFCSE_GET_NFCC_CAPABILITIES retorna informações sobre os recursos atuais do controlador NFC, incluindo o tamanho máximo da tabela de Roteamento do Modo de Escuta (definido na seção 4.2 da NCI (Interface do Controlador NFC) Versão 1.1) e os modos de roteamento com suporte. |
|
IOCTL_NFCSE_GET_ROUTING_TABLE Retorna informações sobre a configuração atual da tabela de roteamento do modo de escuta. |
|
IOCTL_NFCSE_HCE_REMOTE_RECV Retorna o próximo buffer de dados disponível ou, se não houver mais dados em buffer, a solicitação permanecerá pendente até que um buffer de APDU esteja disponível para leitura. |
|
IOCTL_NFCSE_HCE_REMOTE_SEND Transmite a APDU de resposta do DeviceHost NFCEE para o dispositivo remoto. O chamador deve ter certeza de que a APDU de resposta está em conformidade com ISO-IEC 7816-4. |
|
IOCTL_NFCSE_SET_CARD_EMULATION_MODE O código de controle IOCTL_NFCSE_SET_CARD_EMULATION_MODE define se o elemento seguro especificado é exposto no modo de emulação de cartão. |
|
IOCTL_NFCSE_SET_ROUTING_TABLE Configura a tabela de roteamento do modo de escuta do controlador NFC. |
|
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT O código de controle IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT é emitido por um cliente para assinar um evento específico. |
|
IOCTL_NFCSERM_QUERY_RADIO_STATE O IOCTL_NFCSERM_QUERY_RADIO_STATE é usado pelo aplicativo ou serviço de gerenciamento de rádio SE para consultar o estado de energia de rádio atual do dispositivo de proximidade. |
|
IOCTL_NFCSERM_SET_RADIO_STATE O IOCTL_NFCSERM_SET_RADIO_STATE é usado pelo aplicativo ou serviço de gerenciamento de rádio SE para definir o estado de energia de rádio atual do dispositivo de proximidade. |
|
IOCTL_NFP_DISABLE Um cliente envia a solicitação IOCTL_NFP_DISABLE para desabilitar temporariamente assinaturas, publicações e eventos de presença. |
|
IOCTL_NFP_ENABLE O cliente envia a solicitação IOCTL_NFP_ENABLE para reabilitar assinaturas, publicações e eventos de presença desabilitados anteriormente. |
|
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Um cliente envia a solicitação IOCTL_NFP_GET_KILO_BYTES_PER_SECOND para qualquer identificador genérico, que não seja publicado e não assinado, para o dispositivo do provedor. |
|
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Um cliente envia a solicitação IOCTL_NFP_GET_MAX_MESSAGE_BYTES para qualquer identificador genérico, que não seja publicado e não assinado, para o dispositivo de provedor para determinar o tamanho máximo da mensagem com suporte. |
|
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE O cliente envia a solicitação IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE para o identificador de assinatura repetidamente para receber mensagens assinadas à medida que chegam. |
|
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Um cliente interessado em receber notificações de que uma mensagem foi transmitida enviará a solicitação IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE ao driver de proximidade. |
|
IOCTL_NFP_SET_PAYLOAD Um aplicativo cliente envia dados de mensagem e confirma a publicação com a solicitação IOCTL_NFP_SET_PAYLOAD. |
|
IOCTL_SMARTCARD_GET_ATTRIBUTE O IOCTL_SMARTCARD_GET_ATTRIBUTE controlar consultas de código para atributos de cartão inteligente. |
|
IOCTL_SMARTCARD_GET_STATE O código de controle IOCTL_SMARTCARD_GET_STATE obtém o status atual do cartão inteligente. |
|
IOCTL_SMARTCARD_IS_ABSENT O código de controle IOCTL_SMARTCARD_IS_ABSENT retorna imediatamente com STATUS_SUCCESS se nenhum cartão inteligente for detectado no momento. |
|
IOCTL_SMARTCARD_IS_PRESENT O código de controle IOCTL_SMARTCARD_IS_PRESENT detecta se um cartão inteligente é detectado no momento. |
|
IOCTL_SMARTCARD_POWER O Windows pode exigir que um driver tenha esse IOCTL como NOP e retorne o sucesso. |
|
IOCTL_SMARTCARD_SET_ATTRIBUTE O código de controle IOCTL_SMARTCARD_SET_ATTRIBUTE define um atributo e retorna STATUS_SUCCESS no SCARD_ATTR_DEVICE_IN_USE; caso contrário, ele retornará STATUS_NOT_SUPPORTED. |
|
IOCTL_SMARTCARD_SET_PROTOCOL Define o procotol com o qual o driver se comunica com o cartão inteligente depois que o cartão é detectado. |
|
IOCTL_SMARTCARD_TRANSMIT Transmite dados do cliente para o cartão inteligente detectado na APDU compatível com ISO7816-4. |
Enumerações
|
NFC_CX_CE_MODE_CONFIG Essa enumeração especifica sinalizadores de modo de escuta CE. |
|
NFC_CX_DEVICE_MODE Especifica sinalizadores de modo de dispositivo. |
|
NFC_CX_DRIVER_FLAGS Especifica sinalizadores de driver em tempo de execução. |
|
NFC_CX_HOST_ACTION A enumeração NFC_CX_HOST_ACTION especifica ações de host. |
|
NFC_CX_NFCIP_MODE_CONFIG A enumeração NFC_CX_NFCIP_MODE_CONFIG especifica o modo iniciador NFC-IP. |
|
NFC_CX_NFCIP_TGT_MODE_CONFIG A enumeração NFC_CX_NFCIP_TGT_MODE_CONFIG especifica NFC-IP modo de destino. |
|
NFC_CX_POLL_BAILOUT_CONFIG A enumeração NFC_CX_POLL_BAILOUT_CONFIG especifica o resgate do modo de votação. |
|
NFC_CX_POLL_MODE_CONFIG A enumeração NFC_CX_POLL_MODE_CONFIG especifica o modo de votação. |
|
NFC_CX_SEQUENCE A enumeração NFC_CX_SEQUENCE especifica sequências. |
|
NFC_CX_TRANSPORT_TYPE A enumeração NFC_CX_TRANSPORT_TYPE especifica tipos de transporte. |
|
SECURE_ELEMENT_CARD_EMULATION_MODE Essa enumeração indica o modo de emulação de cartão de um elemento seguro. |
|
SECURE_ELEMENT_EVENT_TYPE Indica o tipo de eventos de elemento seguro. |
|
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE é membro do SECURE_ELEMENT_ROUTING_TABLE_ENTRY. |
|
SECURE_ELEMENT_TYPE Indica o tipo de um elemento seguro. |
Funções
|
EVT_NFC_CX_DEVICE_IO_CONTROL Chamado pelo NFC CX para enviar um IOCTL sem tratamento para o driver cliente. |
|
EVT_NFC_CX_SEQUENCE_HANDLER Chamado pelo NFC CX para notificar o driver cliente para lidar com a sequência registrada específica. |
|
EVT_NFC_CX_WRITE_NCI_PACKET Chamado pelo NFC CX para enviar um pacote de gravação para o driver cliente. |
|
NFC_CX_CLIENT_CONFIG_INIT A função NFC_CX_CLIENT_CONFIG_INIT inicializa a estrutura NFC_CX_CLIENT_CONFIG. |
|
NFC_CX_LLCP_CONFIG_INIT A função NFC_CX_LLCP_CONFIG_INIT inicializa a estrutura NFC_CX_LLCP_CONFIG. |
|
NFC_CX_RF_DISCOVERY_CONFIG_INIT A função NFC_CX_RF_DISCOVERY_CONFIG_INIT inicializa a estrutura NFC_CX_RF_DISCOVERY_CONFIG. |
|
NfcCxDeviceDeinitialize A função NfcCxDeviceDeinitialize (nfccx.h) desinitializa um dispositivo WDF que foi criado durante a rotina AddDevice. |
|
NfcCxDeviceInitConfig Chamado pelo driver cliente durante sua rotina AddDevice para executar funções DeviceInit. Durante esse processo, as seguintes funções de retorno de chamada de E/S também são trocadas. |
|
NfcCxDeviceInitialize A função NfcCxDeviceInitialize (nfccx.h) inicializa um dispositivo WDF que foi criado durante a rotina AddDevice. |
|
NfcCxHardwareEvent Chamado pelo driver cliente quando ocorre um evento de hardware, como retornos de chamada D0Entry e D0Exit para iniciar ou parar o dispositivo. Para drivers que exigem o download de firmware na inicialização ou inicialização, é recomendável mover essa chamada para um item de trabalho separado. No entanto, o driver cliente é responsável pelo seguinte. |
|
NfcCxNciReadNotification Chamado pelo driver cliente quando um pacote de leitura está disponível. |
|
NfcCxRegisterSequenceHandler Chamado pelo driver cliente durante a inicialização para se registrar para lidar com sequências específicas. |
|
NfcCxSetLlcpConfig Chamado pelo driver cliente para configurar os parâmetros LLCP. |
|
NfcCxSetRfDiscoveryConfig Chamado pelo driver cliente para configurar os parâmetros de descoberta de RF. |
|
NfcCxUnregisterSequenceHandler Chamado pelo driver cliente durante o desligamento do dispositivo para cancelar o registro do retorno de chamada do manipulador de sequência registrado anteriormente. |
Estruturas
|
NFC_CX_CLIENT_CONFIG A estrutura NFC_CX_CLIENT_CONFIG é um parâmetro de entrada para NfcCxDeviceInitConfig. |
|
NFC_CX_HARDWARE_EVENT A estrutura NFC_CX_HARDWARE_EVENT é um parâmetro de entrada para NfcCxHardwareEvent. |
|
NFC_CX_LLCP_CONFIG A estrutura NFC_CX_LLCP_CONFIG é um parâmetro de entrada para NfcCxSetLlcpConfig. |
|
NFC_CX_RF_DISCOVERY_CONFIG A estrutura NFC_CX_RF_DISCOVERY_CONFIG contém as configurações de descoberta de RF. A configuração de descoberta deve ser concluída durante a inicialização depois de chamar NfcDxDeviceInitialize, caso contrário, um erro será retornado. |
|
NFCCX_DRIVER_GLOBALS A estrutura _NFCCX_DRIVER_GLOBALS contém valores globais para o driver CX da NFC (Near Field Communications). |
|
NFCRM_RADIO_STATE Essa estrutura é usada para indicar o estado do rádio. |
|
NFCRM_SET_RADIO_STATE Essa estrutura é usada para definir o estado de rádio. O motorista, no caso do modo avião, tem que persistir o estado do rádio e restaurá-lo quando o modo avião estiver desabilitado. |
|
SCARD_IO_REQUEST Essa estrutura é usada para identificar uma solicitação de E/S de cartão inteligente. |
|
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO é membro do SECURE_ELEMENT_ROUTING_TABLE_ENTRY. |
|
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO é membro do SECURE_ELEMENT_ENDPOINT_LIST. |
|
SECURE_ELEMENT_ENDPOINT_LIST O parâmetro de saída para IOCTL_NFCSE_ENUM_ENDPOINTS. |
|
SECURE_ELEMENT_EVENT_INFO Essa estrutura fornece informações sobre um evento de elemento seguro. |
|
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO A estrutura SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO é um parâmetro de entrada a ser IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT. |
|
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD A estrutura _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD contém um identificador de conexão exclusivo e tipos de tecnologia e protocolo NFC Forum RF. |
|
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET é um buffer de entrada para IOCTL_NFCSE_HCE_REMOTE_SEND e buffer de saída para IOCTL_NFCSE_HCE_REMOTE_RECV. |
|
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES contém recursos do controlador NFC. |
|
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO é membro do SECURE_ELEMENT_ROUTING_TABLE_ENTRY. |
|
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE é um parâmetro de entrada para IOCTL_NFCSE_SET_ROUTING_TABLE. |
|
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY é membro do SECURE_ELEMENT_ROUTING_TABLE. |
|
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO é o parâmetro de entrada para IOCTL_NFCSE_SET_CARD_EMULATION_MODE. |
|
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO é membro do SECURE_ELEMENT_ROUTING_TABLE_ENTRY. |