функция 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 в качестве критерия поиска. Если использование ненулевое, будут возвращены только значения, указывающие это использование.

[out] ValueCaps

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

[in, out] ValueCapsLength

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

[in] PreparsedData

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

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

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

Замечания

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

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

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

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

Требования

См. также

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetCaps

HidP_GetValueCaps

_HIDP_PREPARSED_DATA