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.Buffer 的 64 個 WCHAR[]
  • 零緩衝區
  • 將 Key.MaximumLength 設定為以位元組為單位的緩衝區大小，以及
  • 設定 Key.Length = 0
在結束回呼例程之前，PEP 必須將以 Null 終止的字串複製到 Key.Buffer ，並以位元組計數更新 Key.Length ，其 大小為 (WCHAR) 複製的 UNICODE 字元數目，不包括終止 UNICODE_NULL。

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

[in/out] Value

PEP 的緩衝區，用來寫入元數據字串組的值部分。

在進入通知回呼例程之前，核心會：

  • 針對 Value.Buffer 預先配置 64 個 WCHAR[]
  • 零緩衝區
  • 將 Value.MaximumLength 設定為以位元組為單位的緩衝區大小，以及
  • 設定 Value.Length = 0
在結束回呼例程之前，PEP 必須將以 Null 終止的字串複製到 Value.Buffer ，並以位元組計數更新 Value.Length ，其 大小為 (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