структура PEP_SOC_SUBSYSTEM_METADATA (pep_x.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 должен скопировать строку, завершающуюся значением NULL, в 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.
Верхняя часть pep_x.h (включая Pep_x.h)

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

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA