HidD_GetPhysicalDescriptor-Funktion (hidsdi.h)

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

Weitere Informationen

HidD_GetIndexedString

HidD_GetManufacturerString

HidD_GetProductString

HidD_GetSerialNumberString

IOCTL_GET_PHYSICAL_DESCRIPTOR