IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)

Il codice di controllo IOCTL_NFCSE_SET_CARD_EMULATION_MODE imposta se l'elemento protetto specificato viene esposto in modalità di emulazione della scheda. Quando un elemento sicuro viene "esposto" come emulazione di carte, significa che quando il dispositivo viene portato a un lettore esterno a cui è possibile accedere tramite il lettore. L'IOCTL viene emesso su un handle di file aperto con un nome file relativo 'SEManage'. Il driver DEVE concedere l'accesso esclusivo al client per gestire la modalità di emulazione delle carte, ovvero le chiamate successive per aprire un handle di file usando il nome file relativo 'SEManage' avranno esito negativo con STATUS_ACCESS_DENIED fino a quando il client con accesso esclusivo chiude il relativo handle di file.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO struttura.

Buffer di output

Nessuno

Blocco di stato

Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. I codici di errore possibili sono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Se il GUID dell'elemento sicuro non è valido o il buffer di output è diverso da zero.
STATUS_INVALID_DEVICE_STATE	Se l'IOCTL viene inviato su un handle diverso dal nome relativo 'SEManage'.

Osservazioni

Di seguito sono riportati i requisiti che il driver deve rispettare.

• Questo IOCTL deve essere chiamato su un handle con un nome file RELATIVO SEEvents; in caso contrario, il driver restituisce STATUS_INVALID_DEVICE_STATE.
• Se la modalità di emulazione della scheda è impostata su EmulationOff per tutti gli elementi sicuri collegati al controller NFC, la modalità di emulazione del ciclo di polling deve essere disabilitata. Se anche le funzionalità di prossimità sono disabilitate, il driver deve passare a una modalità a basso consumo.
• Se la modalità di emulazione della scheda è impostata su un valore diverso da EmulationOff, il driver deve continuare a trovarsi nello stato D0 e la modalità di emulazione del ciclo di polling deve essere abilitata (rilevabile per i lettori esterni).
• Quando l'handle di file aperto SEManage viene chiuso, il driver deve impostare le impostazioni della modalità di emulazione della scheda di tutti gli elementi sicuri come EmulationOff tranne quando l'ultimo stato della modalità di emulazione della scheda impostata è EmulationOnPowerIndependent. Se l'ultimo stato della modalità di emulazione della scheda impostata è EmulationOnPowerIndependent, il driver deve rimanere con l'impostazione modalità di emulazione della scheda su Sì con l'opzione PbF per gli elementi sicuri specifici.
• Il driver deve concedere l'accesso esclusivo al client per gestire la modalità di emulazione delle carte. Le chiamate successive per aprire un handle di file usando il nome file relativo SEManage non riuscirebbero con STATUS_ACCESS_DENIED fino a quando il client con accesso esclusivo chiude il relativo handle di file.

Fabbisogno

Requisito	Valore
intestazione	nfcsedev.h