共用方式為

PEP_QUERY_SOC_SUBSYSTEM 結構 (pep_x.h)

  • 發行項

PEP_QUERY_SOC_SUBSYSTEM結構是由PEP_DPM_QUERY_SOC_SUBSYSTEM通知用來收集晶元 (SoC) 子系統上特定系統的基本資訊。

語法

typedef struct _PEP_QUERY_SOC_SUBSYSTEM {
  [in]     ULONG          PlatformIdleStateIndex;
  [in]     ULONG          SubsystemIndex;
  [out]    PVOID          SubsystemHandle;
  [in/out] UNICODE_STRING ParentName;
  [in/out] UNICODE_STRING SubsystemName;
  [out]    ULONG          MetadataCount;
           ULONG          Flags;
} PEP_QUERY_SOC_SUBSYSTEM, *PPEP_QUERY_SOC_SUBSYSTEM;

成員

[in] PlatformIdleStateIndex

核心正在查詢的平台閑置狀態索引。

[in] SubsystemIndex

子系統索引，這是OS指派給指定 PlatformIdleStateIndex 內容內每個子系統的唯一索引。

核心會將此值初始化為零，並針對每個後續子系統靜態資訊通知遞增此值。 值為 0 表示它是指定 PlatformIdleStateIndex 的第一個這類通知。 此欄位旨在提供此通知實例之間的 PEP 內容。 這是唯一的欄位，其輸入值會因給定 PlatformIdleStateIndex 的實例而有所不同，而 PEP 可能會使用此值來查閱子系統。

PEP 可以忽略此值。

[out] SubsystemHandle

PEP 可以選擇性地指派值的內容指標。 它會在此特定子系統的後續通知上收到指標。 在後續通知中，PEP 會使用 PlatformIdleStateIndex 以及 SubsystemName 和/或 SubsystemHandle 來查閱特定子系統的會計數據。

如果這個成員為零，則預設為值。 OS 會忽略這個值，而且只會用於通知中。

不需要 PEP 才能填滿此成員。

[in/out] ParentName

緩衝區，用於保存對應子系統的父名稱。 每個子系統都有父系和子系統， 且 ParentName 的值相同，會被視為同層級。 子系統同層級階層是選擇性的。 如果沒有任何階層，所有子系統都是最上層子系統，並指定 ParentName的通用值。 若要指出階層，最上層子系統會指定一個通用的ParentName，而每個非最上層子系統都會指定其父子系統的ParentName。

進入之前，核心會：

  • 為 ParentName.Buffer 預先配置 64 個 WCHAR[]
  • 零緩衝區
  • 將 ParentName.MaximumLength 設定為以位元組為單位的緩衝區大小，以及
  • 設定 ParentName.Length = 0
在結束之前，PEP 必須將以 Null 終止的字串複製到 ParentName.Buffer ，並使用位元組計數更新 ParentName.Length ，其 大小為 (WCHAR) 複製的 UNICODE 字元數目，不包括終止 UNICODE_NULL。

PEP 必須使用 ParentName.Buffer 中位址所指向的配置記憶體，以提供父名稱。 由於此記憶體已預先配置，因此無法變更其大小。 PEP 負責視需要截斷父名稱，使其不會超過 ParentName.MaximumLength 中指定的長度， (包括終止 UNICODE_NULL字元) 。

[in/out] SubsystemName

用來保存此子系統名稱的緩衝區。 每個子系統都有子系統名稱， 而且子系統名稱 在給定平臺閑置狀態內容中的所有子系統中都必須是唯一的。 子系統的 SubsystemName 不能與 ParentName 相同。

進入之前，核心會：

  • 針對 SubsystemName.Buffer 預先配置 64 個 WCHAR[]
  • 零緩衝區
  • 將 SubsystemName.MaximumLength 設定為以位元組為單位的緩衝區大小，以及
  • 設定 SubsystemName.Length = 0
在結束之前，PEP 必須將以 Null 終止的字串複製到 SubsystemName.Buffer ，並以位元組計數更新 SubsystemName.Length ，其 大小為 (WCHAR) 複製的 UNICODE 字元數目，不包括終止 UNICODE_NULL。

PEP 必須使用 SubsystemName.Buffer 中位址所指向的已配置記憶體，以提供子系統名稱。 由於此記憶體已預先配置，因此無法變更其大小。 PEP 會在必要時負責截斷子系統名稱，使其不會超過 SubsystemName.MaximumLength 中指定的長度， (包括終止 UNICODE_NULL字元) 。

[out] MetadataCount

此 SoC 子系統所建立的元數據索引鍵/值字串組數目。

元數據是選擇性的。 如果 PEP 未報告此 SoC 子系統的任何元數據，PEP 會傳回零。

Flags

這個成員是保留的，而且應該設定為零。

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
標頭 pep_x.h (包含 Pep_x.h)

另請參閱

PEP_DPM_QUERY_SOC_SUBSYSTEM通知