Leer en inglés

Compartir vía

estructura PEP_SOC_SUBSYSTEM_METADATA (pep_x.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

C++ 
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

Búfer del PEP para escribir la parte de clave del par de cadenas de metadatos. Key debe ser único entre todos los valores de Key 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 sea sizeof(WCHAR) veces el número de caracteres UNICODE copiados, sin incluir 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, de modo que no supere la longitud especificada en key.MaximumLength (incluido el carácter de UNICODE_NULL de terminación).

[in/out] Value

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 sea sizeof(WCHAR) veces el número de caracteres UNICODE copiados, sin incluir la terminación UNICODE_NULL.

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, de modo que no supere la longitud especificada en Value.MaximumLength (incluido el carácter de UNICODE_NULL de terminación).

Requisitos

Requisito Valor
cliente mínimo admitido Se admite a partir de Windows 10.
encabezado de pep_x.h (incluya Pep_x.h)

Consulte también

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA