Condividi tramite

IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Articolo

Configura la tabella di routing in modalità di routing in modalità di ascolto del controller NFC. Si noti che il chiamante deve inviare informazioni di routing della modalità di ascolto complete in una singola chiamata. Il chiamante garantisce che la tabella di routing sia minore del valore cbMaxRoutingTableSize definito in 4.2.5.1. La dimensione totale viene calcolata in base allo standard NCI NFC sec 6.3.2 ed è uguale a Numero di route basate su AID x 4 + somma di cbAid + Numero di route basate su tecnologia x 5 + Numero di route basate su protocolli x 5. Il chiamante garantisce che i valori per le route basate su tecnologia e protocollo siano conformi alla specifica NCI NFC sec 6.3.2.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

SECURE_ELEMENT_ROUTING_TABLE contenente tutte le voci di routing attualmente configurate.

Buffer di output

Nessuno

Blocco dello 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_BUFFER_SIZE Il buffer fornito è maggiore del controller NFC MAX_ROUTING_TABLE_SIZE.
STATUS_FEATURE_NOT_SUPPORTED NFCC non supporta la configurazione di routing in modalità di ascolto.
STATUS_INVALID_PARAMETER Questo stato viene restituito se il buffer di output non è zero o i valori usati per la tecnologia o il protocollo sono conformi alla specifica NFC NCI sec 6.3.2 o se vengono usati ID di intelligenza artificiale duplicati o quando si usa la modalità di routing che non è supportata dalle funzionalità del controller NFC correnti.
STATUS_INVALID_DEVICE_STATE Questo codice viene restituito se l'IOCTL viene inviato in un handle diverso da con il nome relativo 'SEManage'.

Commenti

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

  • Questo IOCTL viene inviato su un handle con un nome di file relativo "SEManage", altrimenti il driver DEVE completarlo con STATUS_INVALID_DEVICE_STATE.
  • Il driver deve avere voci di routing della modalità di ascolto predefinite iniziali che instradano tecnologie RF A, B e F e/o protocollo ISO-DEP indirizzate a UICC SE presente. Queste voci di routing possono essere sostituite in seguito dalla nuova configurazione della tabella di routing in modalità listen avviata dall'host del dispositivo.
  • Il driver garantisce che il protocollo NFC-DEP venga mappato all'host del dispositivo in ogni momento. Anche se il chiamante non specifica questo, il driver deve aggiungere in modo implicito questa regola.
  • Se questo IOCTL viene emesso quando nfcC si trova nello stato di individuazione RF, il driver deve inserire il nfcC nello stato di inattività RF, configurare la tabella di routing e riavviare l'individuazione RF.

Requisiti

Requisito Valore
Intestazione nfcsedev.h