функция 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 (включая Hidsdi.h) |
| Библиотека | Hid.lib |
| DLL | Hid.dll |