Partager via

IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Article

Configure la table de routage du mode d’écoute du contrôleur NFC. Notez que l’appelant doit envoyer des informations de routage complètes en mode d’écoute dans un seul appel. L’appelant doit s’assurer que la table de routage est inférieure à la valeur cbMaxRoutingTableSize définie dans la version 4.2.5.1. La taille totale est calculée conformément à la norme NCI NFC sec 6.3.2 et est égale à Nombre de routes basées sur l’AIDE x 4 + somme de cbAid + Nombre de routes basées sur la technologie x 5 + Nombre d’itinéraires basés sur un protocole x 5. L’appelant doit s’assurer que les valeurs des itinéraires basés sur la technologie et le protocole sont conformes aux spécifications NCI NFC sec 6.3.2.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

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

Mémoire tampon de sortie

None

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_INVALID_BUFFER_SIZE La mémoire tampon fournie était supérieure à la MAX_ROUTING_TABLE_SIZE du contrôleur NFC.
STATUS_FEATURE_NOT_SUPPORTED NfcC ne prend pas en charge la configuration du routage en mode d’écoute.
STATUS_INVALID_PARAMETER Cette status est retournée si la mémoire tampon de sortie est différente de zéro, ou si les valeurs utilisées pour la technologie ou le protocole sont conformes à la spécification NFC NCI sec 6.3.2, si des AID en double sont utilisés, ou si le mode de routage n’est pas pris en charge par les fonctionnalités actuelles du contrôleur NFC.
STATUS_INVALID_DEVICE_STATE Ce code est retourné si l’IOCTL est envoyé sur un handle autre que celui portant le nom relatif « SEManage ».

Remarques

Voici les exigences que le pilote doit respecter.

  • Cet IOCTL est envoyé sur un handle avec un nom de fichier relatif « SEManage », sinon le pilote DOIT le compléter avec STATUS_INVALID_DEVICE_STATE.
  • Le pilote doit avoir des entrées de table de routage en mode d’écoute initiales qui acheminent les technologies RF A, B et F et/ou le protocole ISO-DEP routées vers UICC SE, le cas échéant. Ces entrées de routage peuvent par la suite être remplacées par la nouvelle configuration de table de routage en mode d’écoute initiée par l’hôte de l’appareil.
  • Le pilote doit s’assurer que le protocole NFC-DEP est mappé à l’hôte du périphérique à tout moment. Même si l’appelant ne le spécifie pas, le pilote doit ajouter cette règle implicitement.
  • Si ce IOCTL est émis lorsque le NFCC est à l’état de découverte RF, le pilote doit placer le NFCC dans un état d’inactivité RF, configurer la table de routage et redémarrer la découverte RF.

Configuration requise

Condition requise Valeur
En-tête nfcsedev.h