IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

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 des informations relatives à tous les éléments sécurisés qui ont été énumérés par le pilote, c’est-à-dire le nombre total d’éléments énumérés par SEs de l’info du point de terminaison SE. Sinon, le pilote doit renvoyer 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

Aucun

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

Aucun

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 :

Retour du code	Description
STATUS_INVALID_PARAMETER	Ce code est retourné lorsque la mémoire tampon de sortie n’est pas égale à 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 adhérer.

• 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 » dans lequel l’élément sécurisé est connecté.
• Pour l’élément sécurisé de l’hôte de périphérique, le pilote doit l’énumérer en tant que point de terminaison SE uniquement s’il prend en charge l’émulation de carte d’hôte. GUID utilisé pour DH peut-être une constante fixe définie par le pilote.
• L’appelant est tenu d’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’EE énumérées par le pilote multiplié par la taille des informations de 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.

Exigences

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