fonction HidP_GetExtendedAttributes (hidpi.h)

Article
08/07/2023

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 à 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, de la mémoire tampon Attributs (qui doit être supérieure ou égale à sizeof(HIDP_EXTENDED_ATTRIBUTES).

Valeur retournée

HidP_GetExtendedAttributes retourne l’une des valeurs status suivantes :

Code de retour	Description
HIDP_STATUS_SUCCESS	La routine a retourné avec succès toutes les informations d’attribut étendu du contrôle.
HIDP_STATUS_BUFFER_TOO_SMALL	La mémoire tampon d’attribut n’était pas assez grande 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 d’attribut . La structure d’attributs étendus contient, dans l’ordre consécutif, les membres de longueur fixe (NumGlobalUnknowns, Reserved 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 d’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 du membre NumGlobalUnknowns des informations d’attributs étendus.

Pour plus d’informations, consultez Collections HID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	hidpi.h (inclure Hidpi.h)
Bibliothèque	Hidparse.lib
IRQL	<= niveau DISPATCH_

Voir aussi

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Partager via