次の方法で共有

HidP_GetExtendedAttributes (Windows Embedded CE 6.0)

  • [アーティクル]

1/6/2010

This function returns the extended attributes of a HID control.

Syntax

NTSTATUS HidP_GetExtendedAttributes(
  HIDP_REPORT_TYPE ReportType,
  USHORT DataIndex,
  PHIDP_PREPARSED_DATA PreparsedData,
  PHIDP_EXTENDED_ATTRIBUTES Attributes,
  PULONG LengthAttributes
);

Parameters

  • ReportType
    [in] HIDP_REPORT_TYPE enumerator value that indicates the type of HID report associated with the HID control specified by DataIndex.
  • DataIndex
    [in] Data index of the HID control.
  • PreparsedData
    [in] Preparsed data for the top-level collection that contains the specified control.
  • Attributes
    [out] Pointer to a caller-allocated buffer that the function uses to return the extended attributes of the control specified by DataIndex.
  • LengthAttributes
    [in, out] On input, the size in bytes of the Attributes buffer, which must be greater than or equal to sizeof(HIDP_EXTENDED_ATTRIBUTES). On output, the size in bytes of the Attributes buffer.

Return Value

The following table shows the possible return values.

Value Description

HIDP_STATUS_SUCCESS

Function successfully returned the control's extended attribute information.

HIDP_STATUS_BUFFER_TOO_SMALL

Attribute buffer is not large enough to hold all extended attribute information.

HIDP_STATUS_DATA_INDEX_NOT_FOUND

Specified data index is not valid.

Remarks

HidP_GetExtendedAttributes returns a variable length HIDP_EXTENDED_ATTRIBUTES structure in the Attribute buffer. The HIDP_EXTENDED_ATTRIBUTES extended attributes structure contains, in consecutive order, the fixed length members NumGlobalUnknowns, Reserved, and GlobalUnknowns, followed by a variable length array of HIDP_UNKNOWN_TOKEN structures. The first member of the unknown token array is located at (PHID_UNKNOWN_TOKEN*)&(Attributes->Data).

The function returns as many bytes of the extended attribute information as the Attribute buffer can hold. If the buffer is too small, the function truncates the information it returns. To determine the number of unknown tokens in the variable length array, a caller can first use the Attributes buffer to return the value of the NumGlobalUnknowns member of the extended attributes information.

Requirements

Header hidpi.h
Library Hidparse_lib.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

HID Parser Functions
HIDP_EXTENDED_ATTRIBUTES
HIDP_REPORT_TYPE
HIDP_UNKNOWN_TOKEN