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

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

  • Статья

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

Синтаксис

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Параметры

[in] ReportType

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

[in] UsagePage

Указывает страницу использования в качестве условий поиска. Если значение UsagePage не равно нулю, возвращаются только значения, указывающие эту страницу использования.

[in] LinkCollection

Указывает коллекцию ссылок в качестве условия поиска. Если linkCollection не является нулевым, возвращаются только значения, которые являются частью этой коллекции ссылок.

[in] Usage

Указывает использование HID в качестве условия поиска. Если значение Usage не равно нулю, будут возвращены только значения, указывающие это использование.

[out] ValueCaps

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

[in, out] ValueCapsLength

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

[in] PreparsedData

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

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

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

Код возврата Значение состояния NT Описание
HIDP_STATUS_SUCCESS
0x00110000
 Подпрограмма успешно вернула данные о возможностях.
HIDP_STATUS_INVALID_PREPARSED_DATA
0xc0110001
 Готовые данные недопустимы.
HIDP_STATUS_USAGE_NOT_FOUND
0xc0110004
 Использование не существует ни в одном отчете указанного типа отчета.

Комментарии

Требуемый размер буфера ValueCaps определяется элементами NumberXxxValueCaps структуры HIDP_CAPS коллекции верхнего уровня.

При вызове HidP_GetSpecificValueCaps указание нуля для UsagePage, Usage и LinkCollection эквивалентно вызову HidP_GetValueCaps.

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

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

Требования

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

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

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetCaps

HidP_GetValueCaps

_HIDP_PREPARSED_DATA