Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Подпрограмма 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_GetButtonCaps возвращает возможность всех кнопок в коллекции верхнего уровня для указанного типа отчета.
ButtonCapsLength следует задать значение элемента NumberXxxButtonCaps элемента структуры HIDP_CAPS, возвращаемой HidP_GetCaps, где Xxx указывает тип отчета.
Чтобы получить подмножество возможностей кнопки, выберите , страницы использованияили коллекции ссылок, используйте HidP_GetSpecificButtonCaps.
Дополнительные сведения о возможностях коллекции см. в получения сведений о коллекции.
См. также коллекции HID.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Всеобщий |
| заголовка | hidpi.h (include Hidpi.h) |
| библиотеки | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |