共用方式為

HidP_GetExtendedAttributes函式 （hidpi.h）

  • 發行項

HidP_GetExtendedAttributes 例程會傳回 HID 控制件的擴充屬性。

語法

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

參數

[in] ReportType

指定 HIDP_REPORT_TYPE 列舉值，指出與 DataIndex 所指定之 HID 控制件相關聯的 HID 報表類型。

[in] DataIndex

指定 HID 控制件 資料索引。

[in] PreparsedData

指定包含指定控制項之 最上層集合 預先剖析的數據。

[out] Attributes

呼叫端配置的緩衝區指標，例程會使用此緩衝區傳回由 dataIndex 所指定之控件的擴充屬性。

[in, out] LengthAttributes

指定 屬性 緩衝區的大小，以位元組為單位（必須大於或等於sizeof（HIDP_EXTENDED_ATTRIBUTES）。

傳回值

HidP_GetExtendedAttributes 會傳回下列其中一個狀態值：

傳回碼 描述
HIDP_STATUS_SUCCESS
 例程已成功傳回所有控件的擴充屬性資訊。
HIDP_STATUS_BUFFER_TOO_SMALL
 屬性 緩衝區不夠大，無法保存所有擴充屬性資訊。
HIDP_STATUS_DATA_INDEX_NOT_FOUND
 指定的數據索引無效。

言論

HidP_GetExtendedAttributes 會傳回 Attribute 緩衝區中的可變長度 HIDP_EXTENDED_ATTRIBUTES 結構。 擴充屬性結構會依連續順序包含固定長度成員 （NumGlobalUnknowns、Reserved和 GlobalUnknowns），後面接著可變長度的 HIDP_UNKNOWN_TOKEN 結構數組。 未知令牌陣列的第一個成員位於 （PHIDP_UNKNOWN_TOKEN*）&（Attributes->Data）。

例程會傳回擴充屬性資訊的位元元組數目，因為 屬性 緩衝區可以保存。 如果緩衝區太小，則例程會截斷它傳回的資訊。 若要判斷可變長度陣列中未知的標記數目，呼叫者可以先使用 Attributes 緩衝區來傳回 NumGlobalUnknowns 擴充屬性信息成員的值。

如需詳細資訊，請參閱 HID 集合。

要求

要求 價值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows。
目標平臺 普遍
標頭 hidpi.h （包括 Hidpi.h）
連結庫 Hidparse.lib
IRQL <= DISPATCH_ LEVEL

另請參閱

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA