Condividi tramite

IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Articolo

Configura la tabella di routing in modalità di ascolto del controller NFC. Si noti che il chiamante deve inviare informazioni complete sul routing in modalità di ascolto in una singola chiamata. Il chiamante deve assicurarsi che la tabella di routing sia minore del valore cbMaxRoutingTableSize definito in 4.2.5.1. Le dimensioni totali vengono calcolate in base allo standard NFC NCI sec 6.3.2 ed è uguale a Numero di route basate su AID x 4 + somma di cbAid + Numero di route basate sulla tecnologia x 5 + Numero di route basate su protocollo x 5. Il chiamante garantisce che i valori per le route tecnologiche e basate su protocollo siano conformi alla specifica NFC NCI 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 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_BUFFER_SIZE Il buffer fornito è maggiore del MAX_ROUTING_TABLE_SIZE del controller NFC.
STATUS_FEATURE_NOT_SUPPORTED NFCC non supporta la configurazione del routing in modalità di ascolto.
STATUS_INVALID_PARAMETER Questo stato viene restituito se il buffer di output è diverso da zero o se i valori utilizzati per la tecnologia o il protocollo sono conformi alla specifica NFC NCI sec 6.3.2 o se vengono usati ID AID duplicati oppure quando si usa la modalità di routing non supportata dalle funzionalità correnti del controller NFC.
STATUS_INVALID_DEVICE_STATE Questo codice viene restituito se l'IOCTL viene inviato su un handle diverso da con il nome relativo 'SEManage'.

Osservazioni

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

  • Questo IOCTL viene inviato su un handle con un nome file relativo "SEManage", altrimenti il driver DEVE completarlo con STATUS_INVALID_DEVICE_STATE.
  • Il driver deve avere voci iniziali della tabella di routing in modalità di ascolto predefinita che instradano le tecnologie RF A, B e F e/o ISO-DEP protocollo instradato a UICC SE, se presente. Queste voci di routing potrebbero essere sostituite in seguito dalla nuova configurazione della tabella di routing in modalità di ascolto avviata dall'host del dispositivo.
  • Il driver garantisce che il protocollo NFC-DEP sia mappato all'host del dispositivo in qualsiasi momento. Anche se il chiamante non lo specifica, il driver deve aggiungere questa regola in modo implicito.
  • 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.

Fabbisogno

Requisito Valore
intestazione nfcsedev.h