fonction HidD_GetPreparsedData (hidsdi.h)

La routine HidD_GetPreparsedData retourne les données préparéesd’une collection de niveau supérieur.

Syntaxe

BOOLEAN HidD_GetPreparsedData(
  [in]  HANDLE               HidDeviceObject,
  [out] PHIDP_PREPARSED_DATA *PreparsedData
);

Paramètres

[in] HidDeviceObject

Spécifie un handle ouvert à une collection de niveau supérieur.

[out] PreparsedData

Pointeur vers l’adresse d’une mémoire tampon allouée de routine qui contient les données préparées d’une collection dans une structure _HIDP_PREPARSED_DATA .

Valeur retournée

HidD_GetPreparsedData retourne TRUE si elle réussit ; sinon, il retourne FALSE. Utilisez GetLastError pour obtenir des informations d’erreur étendues.

Remarques

Seules les applications en mode utilisateur peuvent appeler HidD_GetPreparsedData. Les pilotes en mode noyau peuvent utiliser une requête IOCTL_HID_GET_COLLECTION_DESCRIPTOR .

Lorsqu’une application n’a plus besoin des données préparées, elle doit appeler HidD_FreePreparsedData pour libérer la mémoire tampon de données préparées.

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	hidsdi.h (inclure Hidsdi.h)
Bibliothèque	Hid.lib
DLL	Hid.dll

Voir aussi

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA