IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Artigo

Retorna informações sobre a configuração atual da tabela de roteamento do modo de escuta. Observe que o chamador deve alocar um buffer de saída grande o suficiente para manter informações sobre todas as entradas presentes na tabela de roteamento do modo de escuta atual, ou seja, número total de entradas de roteamento x Tamanho da entrada da tabela de roteamento; caso contrário, o driver deve retornar um código de erro STATUS_BUFFER_OVERFLOW para o cliente com o campo NumberOfEntries contendo o número de entradas de tabela de roteamento configuradas. A entrada da tabela de roteamento é do tipo SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Observação: o driver não deve retornar o roteamento de entrada NFC-DEP para DH como parte da tabela de roteamento retornada no buffer de saída, mesmo que a entrada esteja presente na tabela de roteamento NFCC.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum

Comprimento do buffer de entrada

Nenhum

Buffer de saída

SECURE_ELEMENT_ROUTING_TABLE que contém todas as entradas de roteamento configuradas no momento.

Comprimento do buffer de saída

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Os códigos de erro possíveis são:

Código de retorno Descrição
STATUS_BUFFER_OVERFLOW O buffer fornecido era muito pequeno para receber a configuração da tabela de roteamento.
STATUS_FEATURE_NOT_SUPPORTED O NFCC não dá suporte à configuração de roteamento do modo de escuta.
STATUS_INVALID_PARAMETER Esse código será retornado se o buffer de entrada for diferente de zero.
STATUS_INVALID_DEVICE_STATE Esse código será retornado se o IOCTL for enviado em um identificador diferente de com o nome relativo 'SEManage'.

Requisitos

Requisito Valor
Cabeçalho nfcsedev.h