Partager via

IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • Article

Retourne des informations concernant la liste de tous les éléments sécurisés attachés au contrôleur NFC. Notez que l’appelant doit allouer une mémoire tampon de sortie suffisamment grande pour contenir les informations relatives à tous les éléments sécurisés énumérés par le pilote, c’est-à-dire le nombre total d’unités de sécurité énumérées x taille des informations de point de terminaison SE, sinon le pilote doit retourner un code d’erreur STATUS_BUFFER_OVERFLOW au client avec le champ NumberOfEndpoints contenant le nombre d’éléments sécurisés énumérés. GUID identifiant l’élément sécurisé qui peut être utilisé pour faire référence à un élément sécurisé particulier.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

None

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

None

Mémoire tampon de sortie

Une SECURE_ELEMENT_ENDPOINT_LIST pour chaque appareil énuméré.

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_PARAMETER Ce code est retourné lorsque la mémoire tampon de sortie est différente de zéro.
STATUS_BUFFER_OVERFLOW La mémoire tampon fournie était trop petite pour recevoir la configuration de la table de routage.

Remarques

Voici les exigences auxquelles le pilote doit se conformer.

  • Dans le cas d’un élément sécurisé intégré, le GUID doit être un identificateur unique dérivé du numéro de série et/ou d’une autre identification unique de l’élément sécurisé.
  • Pour les éléments sécurisés externes, le GUID peut être une constante fixe et identifie uniquement le « socket » auquel l’élément sécurisé est connecté.
  • Pour l’élément sécurisé de l’hôte d’appareil, le pilote doit l’énumérer comme point de terminaison SE uniquement s’il prend en charge l’émulation de carte hôte. Le GUID utilisé pour DH peut être une constante fixe définie par le pilote.
  • L’appelant doit allouer une mémoire tampon de sortie suffisamment grande pour contenir les informations sur tous les éléments sécurisés énumérés par le pilote. La mémoire tampon doit être égale au nombre total d’unités de sécurité énumérées par le pilote multiplié par la taille des informations du point de terminaison SE. Si la mémoire tampon appropriée n’est pas allouée, le pilote retourne un code d’erreur STATUS_BUFFER_OVERFLOW au client avec le champ NumberOfEndpoints qui contient le nombre d’éléments sécurisés énumérés.

Configuration requise

Condition requise Valeur
En-tête nfcsedev.h