функция HidD_GetPhysicalDescriptor (hidsdi.h)
Подпрограмма HidD_GetPhysicalDescriptor возвращает физический дескриптор коллекции верхнего уровня, которая определяет физическое устройство коллекции.
физический дескриптор используется для указания физической части человеческого тела для активации элементов управления на устройстве. Например, физический дескриптор может указывать на то, что правый палец используется для активации кнопки 5.
Обратите внимание, что физические дескрипторы являются полностью необязательными. Они добавляют сложность и предлагают очень мало взамен для большинства устройств. Однако некоторые устройства, особенно с большим количеством идентичных элементов управления (например, кнопки), будут находить, что физические дескрипторы помочь различным приложениям назначать функциональные возможности этим элементам управления более согласованно. Дополнительные сведения см. в спецификации HID.
Синтаксис
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Параметры
[in] HidDeviceObject
Указывает открытый дескриптор коллекции верхнего уровня.
[out] Buffer
Указатель на выделенный вызывающим буфером, который подпрограмма использует для возврата запрошенного физического дескриптора.
[in] BufferLength
Задает длину буфера в байтах в буфере.
Возвращаемое значение
HidD_GetPhysicalDescriptor возвращает TRUE, если она выполнена успешно; в противном случае возвращается FALSE. Используйте GetLastError для получения расширенных сведений об ошибке.
Замечания
Только приложения в пользовательском режиме могут вызывать HidD_GetPhysicalDescriptor. Драйверы в режиме ядра могут использовать запрос IOCTL_GET_PHYSICAL_DESCRIPTOR.
Дополнительные сведения см. в коллекциях HID.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Всеобщий |
| заголовка | hidsdi.h (include Hidsdi.h) |
| библиотеки | Hid.lib |
| DLL | Hid.dll |