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

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

Синтаксис

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Параметры

[in] ReportType

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

[out] ValueCaps

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

[in, out] ValueCapsLength

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

[in] PreparsedData

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

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

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

Код возврата Описание
HIDP_STATUS_SUCCESS
Подпрограмма успешно вернула данные о возможностях.
HIDP_STATUS_INVALID_PREPARSED_DATA
Подготовленные данные являются недопустимыми.

Комментарии

Правильная длина valueCapsLength определяется элементами NumberXxxValueCaps HIDP_CAPS структуры коллекции верхнего уровня.

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть hidpi.h (включая Hidpi.h)
Библиотека Hidparse.lib
IRQL <= DISPATCH_LEVEL

См. также раздел

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA