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
| 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 |