Compartilhar via

IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)

  • Artigo

O código de controle IOCTL_NFCSE_SET_CARD_EMULATION_MODE define se o elemento seguro especificado é exposto no modo de emulação cartão. Quando um elemento seguro é "exposto" como cartão emulação, isso significa que quando o dispositivo é levado a um leitor externo, esse elemento seguro pode ser acessado pelo leitor. O IOCTL é emitido em um identificador de arquivo aberto com um nome de arquivo relativo 'SEManage'. O driver DEVE conceder acesso exclusivo ao cliente para gerenciar cartão modo de emulação, ou seja, chamadas subsequentes para abrir um identificador de arquivo usando o nome de arquivo relativo 'SEManage' falharão com STATUS_ACCESS_DENIED até que o cliente com acesso exclusivo feche seu identificador de arquivo.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO estrutura.

Buffer de saída

Nenhum

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_INVALID_PARAMETER Se o GUID do elemento seguro for inválido ou o buffer de saída não for zero.
STATUS_INVALID_DEVICE_STATE Se o IOCTL for enviado em um identificador diferente de com o nome relativo 'SEManage'.

Comentários

A seguir estão os requisitos aos quais o driver deve aderir.

  • Esse IOCTL deve ser chamado em um identificador que tenha um nome de arquivo relativo SEEvents; caso contrário, o driver retornará STATUS_INVALID_DEVICE_STATE.
  • Se cartão modo de emulação for definido como EmulationOff para todos os elementos seguros anexados ao controlador NFC, o modo de emulação do loop de sondagem deverá ser desabilitado. Se os recursos de proximidade também estiverem desabilitados, o driver deverá fazer a transição para um modo de baixa potência.
  • Se cartão modo de emulação for definido como um valor diferente de EmulationOff, o driver deverá continuar no estado D0 e o modo de emulação do loop de sondagem deverá ser habilitado (detectável para leitores externos).
  • Quando o identificador de arquivo aberto SEManage é fechado, o driver deve definir as configurações do modo de emulação cartão de todos os elementos seguros para serem EmulationOff, exceto quando o último conjunto cartão estado do modo de emulação for EmulationOnPowerIndependent. Se o último conjunto cartão estado do modo de emulação for EmulationOnPowerIndependent, o driver deverá permanecer com a configuração cartão modo de emulação como Ativado com a opção PbF para os elementos seguros específicos.
  • O driver deve conceder acesso exclusivo ao cliente para gerenciar cartão modo de emulação. Chamadas subsequentes para abrir um identificador de arquivo usando o nome de arquivo relativo SEManage falhariam com STATUS_ACCESS_DENIED até que o cliente com acesso exclusivo feche seu identificador de arquivo.

Requisitos

Requisito Valor
Cabeçalho nfcsedev.h