HidD_GetPhysicalDescriptor-Funktion (hidsdi.h)
Die HidD_GetPhysicalDescriptor Routine gibt den physischen Deskriptor einer Auflistung auf oberster Ebene zurück, die das physische Gerät der Auflistung identifiziert.
physische 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 darauf hinweisen, dass der rechte Daumen zum Aktivieren von Schaltfläche 5 verwendet wird.
Beachten Sie, dass physische Deskriptoren vollständig optional sind. Sie fügen Komplexität hinzu und bieten für die meisten Geräte nur sehr wenig. Einige Geräte, insbesondere geräte mit einer großen Anzahl identischer Steuerelemente (z. B. Schaltflächen), werden jedoch feststellen, dass physische Deskriptoren verschiedenen Anwendungen dabei helfen, diesen Steuerelementen auf konsistentere Weise Funktionen 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
Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, den die Routine verwendet, um den angeforderten physischen Deskriptor zurückzugeben.
[in] BufferLength
Gibt die Länge des Puffers in Bytes bei Pufferan.
Rückgabewert
HidD_GetPhysicalDescriptor 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_GetPhysicalDescriptoraufrufen. Kernelmodustreiber können eine IOCTL_GET_PHYSICAL_DESCRIPTOR Anforderung verwenden.
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 |