HidP_GetSpecificValueCaps - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// hidpi.h

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
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-hidpi-hidp_getspecificvaluecaps)

HidP_GetSpecificValueCaps function

Description

The HidP_GetSpecificValueCaps routine returns a value capability array that describes all HID control values that meet a specified selection criteria.

Parameters

ReportType [in]

Specifies a HIDP_REPORT_TYPE enumerator value that identifies the report type.

UsagePage [in]

Specifies a usage page as a search criteria. If UsagePage is nonzero, only values that specify this usage page are returned.

LinkCollection [in]

Specifies a link collection as a search criteria. If LinkCollection is nonzero, only values that are part of this link collection are returned.

Usage [in]

Specifies a HID usage as a search criteria. If Usage is nonzero, only values that specify this usage will be returned.

ValueCaps [out]

Pointer to a caller-allocated buffer in which the routine returns a value capability array for the specified report type.

ValueCapsLength [in, out]

Specifies the length on input, in array elements, of the buffer provided at ValueCaps. On output, this parameter is set to the number of elements that routine actually returns.

PreparsedData [in]

Pointer to a top-level collection's preparsed data.

Return value

HidP_GetSpecificValueCaps returns one of the following status values:

Return code NT Status Value Description
HIDP_STATUS_SUCCESS 0x00110000 The routine successfully returned the capability data.
HIDP_STATUS_INVALID_PREPARSED_DATA 0xc0110001 The preparsed data is not valid.
HIDP_STATUS_USAGE_NOT_FOUND 0xc0110004 The usage does not exist in any report of the specified report type.

Remarks

The required size of the ValueCaps buffer is specified by the NumberXxxValueCaps members of a top-level collection's HIDP_CAPS structure.

When calling HidP_GetSpecificValueCaps, specifying zero for UsagePage, Usage, and LinkCollection is equivalent to calling HidP_GetValueCaps.

For more information about a collection's capability, see Obtaining Collection Information.

See also HID Collections.

See also

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetCaps

HidP_GetValueCaps

_HIDP_PREPARSED_DATA

View the official Windows Driver Kit DDI reference

Edit description on GitHub