IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

Restituisce informazioni sulla configurazione corrente della tabella di routing in modalità di ascolto. Si noti che il chiamante deve allocare un buffer di output sufficientemente grande per contenere informazioni relative a tutte le voci presenti nella tabella di routing in modalità di ascolto corrente, ad esempio numero totale di voci di routing x Dimensione della voce della tabella di routing. In caso contrario, il driver deve restituire un codice di errore STATUS_BUFFER_OVERFLOW al client con il campo NumberOfEntries contenente il numero di voci della tabella di routing configurate. La voce della tabella di routing è di tipo SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Nota: il driver non deve restituire il routing delle voci NFC-DEP a DH come parte della tabella di routing restituita nel buffer di output anche se la voce è presente nella tabella di routing NFCC.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno

Lunghezza del buffer di input

Nessuno

Buffer di output

SECURE_ELEMENT_ROUTING_TABLE contenente tutte le voci di routing attualmente configurate.

Lunghezza del buffer di output

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

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_BUFFER_OVERFLOW	Il buffer fornito era troppo piccolo per ricevere la configurazione della tabella di routing.
STATUS_FEATURE_NOT_SUPPORTED	NFCC non supporta la configurazione del routing in modalità di ascolto.
STATUS_INVALID_PARAMETER	Questo codice viene restituito se il buffer di input è diverso da zero.
STATUS_INVALID_DEVICE_STATE	Questo codice viene restituito se l'IOCTL viene inviato su un handle diverso da con il nome relativo 'SEManage'.

Fabbisogno

Requisito	Valore
intestazione	nfcsedev.h