IOCTL_SMARTCARD_GET_ATTRIBUTE IOCTL (winsmcrd.h)

O IOCTL_SMARTCARD_GET_ATTRIBUTE controlar consultas de código para attribues de cartão inteligentes.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

(DWORD) contém a marca de atributo.

Buffer de saída

(DWORD) contém a marca de atributo.

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_NOT_SUPPORTED Esse código será retornado se o atributo não tiver suporte.
STATUS_INVALID_PARAMETER Esse código será retornado se os buffers de entrada ou saída forem inválidos.
STATUS_BUFFER_TOO_SMALL Esse código será retornado se o buffer de saída for muito pequeno para os dados de retorno.
STATUS_INVALID_DEVICE_STATE Esse código será retornado se o dispositivo não puder aceitar a solicitação.
STATUS_DEVICE_POWERED_OFF Esse código será retornado se o controle de rádio de proximidade estiver desativado quando a chamada for feita.

Comentários

As seguintes ações são necessárias ao usar este IOCTL:

  • O driver deve dar suporte a CancelIo nesse IOCTL pendente.

  • Se esse IOCTL for emitido quando o NFCC estiver no estado de descoberta de RF, o driver precisará colocar o NFCC no estado ocioso de RF, configurar a tabela de roteamento e reiniciar a descoberta de RF.

Requisitos

Requisito Valor
Cabeçalho winsmcrd.h

Confira também

Guia de design da NFC (comunicação de campo próximo)

Guia de design de cartão inteligente