Поделиться через


функция HidP_GetButtonCaps (hidpi.h)

Подпрограмма HidP_GetButtonCaps возвращает массив возможностей кнопки, описывающий все кнопки управления HID в коллекции коллекции верхнего уровня для указанного типа отчета HID.

Синтаксис

NTSTATUS HidP_GetButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Параметры

[in] ReportType

Задает значение перечислителя HIDP_REPORT_TYPE, определяющее тип отчета.

[out] ButtonCaps

Указатель на выделенный вызывающим буфером, который подпрограмма использует для возврата массива возможностей кнопки для указанного типа отчета.

[in, out] ButtonCapsLength

Указывает длину входных данных в элементах массива буфера, предоставленного в ButtonCaps. В выходных данных этот параметр имеет фактическое количество элементов, возвращаемых подпрограммой.

[in] PreparsedData

Указатель на предварительно подготовленныхданных коллекции верхнего уровня.

Возвращаемое значение

HidP_GetButtonCaps возвращает одно из следующих значений состояния:

Возвращаемый код Описание
HIDP_STATUS_SUCCESS
Подпрограмма успешно вернула данные о возможностях.
HIDP_STATUS_INVALID_PREPARSED_DATA
Предварительно подготовленные данные недопустимы.

Замечания

HidP_GetButtonCaps возвращает возможность всех кнопок в коллекции верхнего уровня для указанного типа отчета.

ButtonCapsLength следует задать значение элемента NumberXxxButtonCaps элемента структуры HIDP_CAPS, возвращаемой HidP_GetCaps, где Xxx указывает тип отчета.

Чтобы получить подмножество возможностей кнопки, выберите , страницы использованияили коллекции ссылок, используйте HidP_GetSpecificButtonCaps.

Дополнительные сведения о возможностях коллекции см. в получения сведений о коллекции.

См. также коллекции HID.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows 2000 и более поздних версиях Windows.
целевая платформа Всеобщий
заголовка hidpi.h (include Hidpi.h)
библиотеки Hidparse.lib
IRQL PASSIVE_LEVEL

См. также

HIDP_BUTTON_CAPS

HidP_GetCaps

HidP_GetSpecificButtonCaps

_HIDP_PREPARSED_DATA