IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)
Retourne des informations relatives à la configuration actuelle de la table de routage en 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 en 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 renvoyer 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 la table de routage est de type SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Remarque : Le pilote ne doit pas renvoyer d’entrée le routage 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
Mémoire tampon d'entrée
None
Longueur de la mémoire tampon d’entrée
None
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 :
| Code de retour | 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 | Le NFCC ne prend pas en charge la configuration du routage en 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 que celui portant le nom relatif « SEManage ». |
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | nfcsedev.h |