fonction HidP_GetExtendedAttributes (hidpi.h)

Article
02/07/2025

La routine HidP_GetExtendedAttributes retourne les attributs étendus d’un contrôle HID.

Syntaxe

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

Paramètres

[in] ReportType

Spécifie une valeur d’énumérateur HIDP_REPORT_TYPE qui indique le type de rapport HID associé au contrôle HID spécifié par DataIndex.

[in] DataIndex

Spécifie l’index de données du contrôle HID.

[in] PreparsedData

Spécifie les données préparées pour la collection de niveau supérieur qui contient le contrôle spécifié.

[out] Attributes

Pointeur vers une mémoire tampon allouée par l’appelant que la routine utilise pour retourner les attributs étendus du contrôle spécifié par DataIndex.

[in, out] LengthAttributes

Spécifie la taille, en octets, des attributs tampon (qui doit être supérieur ou égal à sizeof(HIDP_EXTENDED_ATTRIBUTES).

Valeur de retour

HidP_GetExtendedAttributes retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
HIDP_STATUS_SUCCESS	La routine a correctement retourné toutes les informations d’attribut étendue du contrôle.
HIDP_STATUS_BUFFER_TOO_SMALL	L’attribut tampon n’était pas suffisamment grand pour contenir toutes les informations d’attribut étendues.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	L’index de données spécifié n’est pas valide.

Remarques

HidP_GetExtendedAttributes retourne une structure de longueur variable HIDP_EXTENDED_ATTRIBUTES dans la mémoire tampon Attribut. La structure d’attributs étendus contient, dans l’ordre consécutif, les membres de longueur fixe (NumGlobalUnknowns, réservés et GlobalUnknowns) suivis d’un tableau de longueur variable de structures HIDP_UNKNOWN_TOKEN. Le premier membre du tableau de jetons inconnu se trouve à (PHIDP_UNKNOWN_TOKEN*)&(Attributes->Data).

La routine retourne autant d’octets des informations d’attribut étendues que la mémoire tampon attribut peut contenir. Si la mémoire tampon est trop petite, la routine tronque les informations qu’elle retourne. Pour déterminer le nombre de jetons inconnus dans le tableau de longueur variable, un appelant peut d’abord utiliser la mémoire tampon Attributes pour retourner la valeur de l'NumGlobalUnknowns membre des informations d’attributs étendus.

Pour plus d’informations, consultez collections HID.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 2000 et versions ultérieures de Windows.
plateforme cible	Universel
d’en-tête	hidpi.h (include Hidpi.h)
bibliothèque	Hidparse.lib
IRQL	<= niveau de DISPATCH_

Voir aussi

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Partager via