Freigeben über


HidD_GetPreparsedData-Funktion (hidsdi.h)

Die HidD_GetPreparsedData Routine gibt die vordefinierten DateneinerAuflistung auf oberster Ebene zurück.

Syntax

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

Parameter

[in] HidDeviceObject

Gibt ein geöffnetes Handle für eine Auflistung der obersten Ebene an.

[out] PreparsedData

Zeigen Sie auf die Adresse eines routinegeteilten Puffers, der die vordefinierten Daten einer Auflistung in einer _HIDP_PREPARSED_DATA Struktur enthält.

Rückgabewert

HidD_GetPreparsedData gibt TRUE- zurück, wenn dies erfolgreich ist; andernfalls wird FALSE-zurückgegeben. Verwenden Sie GetLastError-, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Nur Benutzermodusanwendungen können HidD_GetPreparsedDataaufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_COLLECTION_DESCRIPTOR Anforderung verwenden.

Wenn eine Anwendung die vordefinierten Daten nicht mehr benötigt, sollte sie HidD_FreePreparsedData aufrufen, um den vordefinierten Datenpuffer freizulegen.

Weitere Informationen finden Sie unter HID Collections.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform- Universal
Header- hidsdi.h (include Hidsdi.h)
Library Hid.lib
DLL- Hid.dll

Siehe auch

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA