HidD_GetPreparsedData-Funktion (hidsdi.h)

  • Artikel

Die HidD_GetPreparsedData Routine gibt die vorbereiteten Daten einer Sammlung 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

Zeiger auf die Adresse eines routinemäßig zugeordneten Puffers, der die vorbereiteten Daten einer Sammlung 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 abzurufen.

Hinweise

Nur Anwendungen im Benutzermodus können HidD_GetPreparsedData aufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_COLLECTION_DESCRIPTOR Anforderung verwenden.

Wenn eine Anwendung die vorbereiteten Daten nicht mehr benötigt, sollte sie HidD_FreePreparsedData aufrufen, um den vorbereiteten Datenpuffer frei zu geben.

Weitere Informationen finden Sie unter HID-Sammlungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header hidsdi.h (include Hidsdi.h)
Bibliothek Hid.lib
DLL Hid.dll

Weitere Informationen

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA