IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

Retourne des informations concernant la configuration actuelle de la table de routage du mode d’écoute. Notez que l’appelant doit allouer une mémoire tampon de sortie suffisamment grande pour contenir des informations concernant toutes les entrées présentes dans la table de routage du mode d’écoute actuelle, c’est-à-dire le nombre total d’entrées de routage x Taille de l’entrée de table de routage, sinon le pilote doit retourner un code d’erreur STATUS_BUFFER_OVERFLOW au client avec le champ NumberOfEntries contenant le nombre d’entrées de table de routage configurées. L’entrée de table de routage est de type SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Remarque : Le pilote ne doit pas retourner le routage d’entrée NFC-DEP vers DH dans le cadre de la table de routage retournée dans la mémoire tampon de sortie, même si l’entrée est présente dans la table de routage NFCC.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Aucun

Longueur de la mémoire tampon d’entrée

Aucun

Mémoire tampon de sortie

SECURE_ELEMENT_ROUTING_TABLE contenant toutes les entrées de routage actuellement configurées.

Longueur de la mémoire tampon de sortie

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

Bloc d’état

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Les codes d’erreur possibles sont les suivants :

Retour du code	Description
STATUS_BUFFER_OVERFLOW	La mémoire tampon fournie était trop petite pour recevoir la configuration de la table de routage.
STATUS_FEATURE_NOT_SUPPORTED	NfcC ne prend pas en charge la configuration du routage du mode d’écoute.
STATUS_INVALID_PARAMETER	Ce code est retourné si la mémoire tampon d’entrée est différente de zéro.
STATUS_INVALID_DEVICE_STATE	Ce code est retourné si le IOCTL est envoyé sur un handle autre qu’avec le nom relatif « SEManage ».

Exigences

Exigence	Valeur
d’en-tête	nfcsedev.h