HidD_GetPhysicalDescriptor-Funktion (hidsdi.h)

Artikel
02/29/2024

Die HidD_GetPhysicalDescriptor Routine gibt den physischen Deskriptor einer Sammlung der obersten Ebene zurück, die das physische Gerät der Sammlung identifiziert.

Physischer Deskriptor wird verwendet, um anzugeben, welcher physische Teil des menschlichen Körpers verwendet wird, um die Steuerelemente auf einem Gerät zu aktivieren. Beispielsweise kann ein physischer Deskriptor angeben, dass der rechte Daumen zum Aktivieren der Schaltfläche 5 verwendet wird.

Beachten Sie, dass physische Deskriptoren völlig optional sind. Sie erhöhen die Komplexität und bieten sehr wenig Im Gegenzug für die meisten Geräte. Einige Geräte, insbesondere Geräte mit einer großen Anzahl identischer Steuerelemente (z. B. Schaltflächen), stellen jedoch fest, dass physische Deskriptoren verschiedenen Anwendungen helfen, diesen Steuerelementen funktionen auf konsistentere Weise zuzuweisen. Weitere Informationen finden Sie unter HID-Spezifikation .

Syntax

BOOLEAN HidD_GetPhysicalDescriptor(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  Buffer,
  [in]  ULONG  BufferLength
);

Parameter

[in] HidDeviceObject

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

[out] Buffer

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der von der Routine verwendet wird, um den angeforderten physischen Deskriptor zurückzugeben.

[in] BufferLength

Gibt die Länge des Puffers unter Buffer in Byte an.

Rückgabewert

HidD_GetPhysicalDescriptor gibt TRUE zurück, wenn dies erfolgreich ist. Andernfalls wird FALSE zurückgegeben. Verwenden Sie GetLastError , um erweiterte Fehlerinformationen abzurufen.

Hinweise

Nur Benutzermodusanwendungen können HidD_GetPhysicalDescriptor aufrufen. Kernelmodustreiber können eine IOCTL_GET_PHYSICAL_DESCRIPTOR-Anforderung verwenden.

Weitere Informationen finden Sie unter HID-Auflistungen.

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