HidP_GetSpecificButtonCaps - NtDoc

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

NTSTATUS HidP_GetSpecificButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [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_getspecificbuttoncaps)

HidP_GetSpecificButtonCaps function

Description

The HidP_GetSpecificButtonCaps routine returns a button capability array that describes all HID control buttons in a top-level collection 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 buttons that specify this usage page are returned.

LinkCollection [in]

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

Usage [in]

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

ButtonCaps [out]

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

ButtonCapsLength [in, out]

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

PreparsedData [in]

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

Return value

HidP_GetSpecificButtonCaps returns one of the following status values:

Return code Description
HIDP_STATUS_SUCCESS The routine successfully returned the capability data.
HIDP_STATUS_INVALID_PREPARSED_DATA The preparsed data is not valid.

Remarks

The required size of the ButtonCaps array is specified by the NumberXxxButtonCaps members of a top-level collection's HIDP_CAPS structure.

When calling HidP_GetSpecificButtonCaps, specifying zero for UsagePage, Usage, and LinkCollection is equivalent to calling HidP_GetButtonCaps.

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

See also HID Collections.

See also

HIDP_BUTTON_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA

View the official Windows Driver Kit DDI reference

Edit description on GitHub