Partager via


fonction HidD_GetPreparsedData (hidsdi.h)

La routine HidD_GetPreparsedData retourne une collection de niveau supérieurde données préparées.

Syntaxe

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

Paramètres

[in] HidDeviceObject

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

[out] PreparsedData

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

Valeur de retour

HidD_GetPreparsedData retourne TRUE si elle réussit ; sinon, elle 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éparsées, elle doit appeler HidD_FreePreparsedData pour libérer la mémoire tampon de données préparsée.

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

Voir aussi

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA