структура PEP_SOC_SUBSYSTEM_METADATA (pepfx.h)

  • Статья

Структура PEP_SOC_SUBSYSTEM_METADATA содержит пары "ключ-значение", содержащие метаданные для системы в подсистеме микросхемы (SoC). Он используется в контексте уведомления PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA , отправляемого в подключаемый модуль расширения платформы (PEP).

Синтаксис

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 для записи ключевой части пары строк метаданных. Ключ должен быть уникальным среди всех значений ключей , сообщаемых этой подсистемой.

Перед входом в подпрограмму обратного вызова уведомления ядро будет выполнять следующие действия:

  • Предварительное выделение 64 WCHAR для Key.Buffer[]
  • Ноль буфера
  • Задайте для параметра Key.MaximumLength размер буфера в байтах и
  • Задать key.Length = 0
Перед выходом из подпрограммы обратного вызова PEP должен скопировать строку, завершающуюся нулевым значением, в Key.Buffer и обновить Key.Length с числом байтов, которое равно sizeof(WCHAR) кратно количеству скопированных символов ЮНИКОДа, не включая завершающий UNICODE_NULL.

Чтобы предоставить ключ, PEP должен использовать выделенную память, на которую указывает адрес в Key.Buffer . Так как эта память предварительно выделена, ее размер нельзя изменить. При необходимости PEP отвечает за усечение ключевой строки, чтобы она не превышала длину, указанную в Key.MaximumLength (включая символ конца UNICODE_NULL ).

[in/out] Value

Буфер для PEP для записи части значения пары строк метаданных.

Перед входом в подпрограмму обратного вызова уведомления ядро будет выполнять следующие действия:

  • Предварительное выделение 64 WCHAR для Value.Buffer[]
  • Ноль буфера
  • Задайте для параметра Value.MaximumLength размер буфера в байтах, и
  • Задать значение.Длина = 0
Перед выходом из подпрограммы обратного вызова PEP должен скопировать строку со значением NULL в Value.Buffer и обновить Value.Length с числом байтов, которое равно sizeof(WCHAR) кратно количеству скопированных символов ЮНИКОДа, не включая завершающий UNICODE_NULL.

Для предоставления значения метаданных PEP должен использовать выделенную память, на которую указывает адрес в Value.Buffer . Так как эта память предварительно выделена, ее размер нельзя изменить. При необходимости PEP отвечает за усечение строки значения, чтобы она не превышала длину, указанную в параметре Value.MaximumLength (включая завершающий символ UNICODE_NULL ).

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Верхняя часть pepfx.h (включая Pep_x.h)

См. также раздел

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA