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 en mode d’écoute complètes 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 en fonction de la norme NFC NCI s 6.3.2 et est égale au nombre d’itinéraires basés sur l’AIDE x 4 + somme de cbAid + nombre d’itinéraires basés sur la technologie x 5 + nombre d’itinéraires basés sur le 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 NFC NCI 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

Aucun

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_INVALID_BUFFER_SIZE La mémoire tampon fournie était supérieure au contrôleur NFC MAX_ROUTING_TABLE_SIZE.
STATUS_FEATURE_NOT_SUPPORTED NfcC ne prend pas en charge la configuration du routage du mode d’écoute.
STATUS_INVALID_PARAMETER Cet état est retourné si la mémoire tampon de sortie n’est pas zéro, ou si les valeurs utilisées pour la technologie ou le protocole sont conformes aux spécifications NFC NCI sec 6.3.2, ou si des AID en double sont utilisés, ou lorsque vous utilisez le mode de routage qui n’est pas pris en charge par les fonctionnalités actuelles du contrôleur NFC.
STATUS_INVALID_DEVICE_STATE Ce code est retourné si le IOCTL est envoyé sur un handle autre qu’avec le nom relatif « SEManage ».

Remarques

Voici les exigences auxquelles le pilote doit adhérer.

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

Exigences

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