функция HidD_GetPhysicalDescriptor (hidsdi.h)

Статья
08/07/2023

Подпрограмма 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 для получения расширенных сведений об ошибке.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	hidsdi.h (включая Hidsdi.h)
Библиотека	Hid.lib
DLL	Hid.dll