Partager via


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