Partager via


fonction HidP_GetExtendedAttributes (hidpi.h)

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