共用方式為


PEP_SOC_SUBSYSTEM_METADATA結構 (pepfx.h)

PEP_SOC_SUBSYSTEM_METADATA 結構包含索引鍵/值組,其中包含晶元 (SoC) 子系統上系統的元數據。 它用於傳送至平臺擴充功能外掛程式(PEP)的 PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA 通知內容中。

語法

typedef struct _PEP_SOC_SUBSYSTEM_METADATA {
  [in/out] UNICODE_STRING Key;
  [in/out] UNICODE_STRING Value;
} PEP_SOC_SUBSYSTEM_METADATA, *PPEP_SOC_SUBSYSTEM_METADATA;

成員

[in/out] Key

PEP 的緩衝區,可寫入元數據字串組的索引鍵部分。 Key 在這個子系統所報告的所有 Key 值中都必須是唯一的。

在進入通知回呼例程之前,核心會:

  • 預先配置 64 WCHARKey.Buffer[]
  • 零緩衝區
  • Key.MaximumLength 設定為以位元組為單位的緩衝區大小,以及
  • 設定 Key.Length = 0
在結束回呼例程之前,PEP 必須將 null 終止的字串複製到 Key.Buffer,並以位元組計數更新 Key.Length,該位元組計數 sizeof(WCHAR) 複製的 UNICODE 字元數目,不包括終止 UNICODE_NULL

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

[in/out] Value

PEP 的緩衝區,可寫入元數據字串組的值部分。

在進入通知回呼例程之前,核心會:

  • 預先配置 64 WCHARValue.Buffer[]
  • 零緩衝區
  • Value.MaximumLength 設定為以位元組為單位的緩衝區大小,以及
  • 設定 Value.Length = 0
在結束回呼例程之前,PEP 必須將 null 終止的字串複製到 Value.Buffer,並以位元組計數更新 Value.Length,該位元組計數 sizeof(WCHAR) 複製的 UNICODE 字元數,不包括終止 UNICODE_NULL

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

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始支援。
標頭 pepfx.h (include Pep_x.h)

另請參閱

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA