IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)

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. Quando um elemento seguro é "exposto" como emulação de cartão, significa quando o dispositivo é levado a um leitor externo que o 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 o modo de emulação de cartã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 do nome relativo 'SEManage'.

Observações

Veja a seguir os requisitos aos quais o driver deve aderir.

• Este 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 o modo de emulação de cartão estiver 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 o modo de emulação de cartão estiver 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 for fechado, o driver deverá definir as configurações do modo de emulação de cartão de todos os elementos seguros para serem EmulationOff, exceto quando o estado do modo de emulação de cartão do último conjunto for EmulationOnPowerIndependent. Se o estado do modo de emulação de cartão do último conjunto for EmulationOnPowerIndependent, o driver deverá permanecer com a configuração do modo de emulação de cartão como Ativado com a opção PbF para os elementos seguros específicos.
• O driver deve conceder acesso exclusivo ao cliente para gerenciar o modo de emulação de cartã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