estructura PEP_SOC_SUBSYSTEM_METADATA (pepfx.h)

  • Artículo

La estructura PEP_SOC_SUBSYSTEM_METADATA contiene pares clave-valor que contienen metadatos para un sistema en un subsistema de chip (SoC). Se usa en el contexto de una notificación de PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA enviada a un complemento de extensión de plataforma (PEP).

Sintaxis

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

Miembros

[in/out] Key

Un búfer para que el PEP escriba la parte clave del par de cadenas de metadatos. La clave debe ser única entre todos los valores de clave notificados por este subsistema.

Antes de entrar en la rutina de devolución de llamada de notificación, el kernel hará lo siguiente:

  • Asignar previamente 64 WCHAR para Key.Buffer[]
  • Cero el búfer
  • Establezca Key.MaximumLength en el tamaño del búfer en bytes y
  • Establecer Key.Length = 0
Antes de salir de la rutina de devolución de llamada, el PEP debe copiar una cadena terminada en null en Key.Buffer y actualizar Key.Length con un recuento de bytes que es sizeof(WCHAR) veces el número de caracteres UNICODE copiados, no incluida la terminación UNICODE_NULL.

El PEP debe usar la memoria asignada a la que apunta la dirección de Key.Buffer para proporcionar la clave. Dado que esta memoria está asignada previamente, no se puede cambiar su tamaño. El PEP es responsable de truncar la cadena de clave, si es necesario, para que no supere la longitud especificada en Key.MaximumLength (incluida la terminación UNICODE_NULL carácter).

[in/out] Value

Un búfer para que el PEP escriba la parte de valor del par de cadenas de metadatos.

Antes de entrar en la rutina de devolución de llamada de notificación, el kernel hará lo siguiente:

  • Asignar previamente 64 WCHAR para Value.Buffer[]
  • Cero el búfer
  • Establezca Value.MaximumLength en el tamaño del búfer en bytes y
  • Establecer Value.Length = 0
Antes de salir de la rutina de devolución de llamada, el PEP debe copiar una cadena terminada en null en Value.Buffer y actualizar Value.Length con un recuento de bytes que es sizeof(WCHAR) veces el número de caracteres UNICODE copiados, no incluida la UNICODE_NULL de terminación.

El PEP debe usar la memoria asignada a la que apunta la dirección de Value.Buffer para proporcionar el valor de metadatos. Dado que esta memoria está asignada previamente, no se puede cambiar su tamaño. El PEP es responsable de truncar la cadena de valor, si es necesario, para que no supere la longitud especificada en Value.MaximumLength (incluida la terminación UNICODE_NULL carácter).

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Encabezado pepfx.h (include Pep_x.h)

Consulte también

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA