estrutura PEP_SOC_SUBSYSTEM_METADATA (pepfx.h)

  • Artigo

A estrutura PEP_SOC_SUBSYSTEM_METADATA contém pares chave-valor que contêm metadados para um sistema em um subsistema SoC (chip). Ele é usado no contexto de uma notificação de PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA enviada a um PEP (plug-in de extensão de plataforma).

Sintaxe

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

Membros

[in/out] Key

Um buffer para o PEP gravar a parte da chave do par de cadeias de caracteres de metadados. A chave deve ser exclusiva entre todos os valores de chave relatados por esse subsistema.

Antes da entrada na rotina de retorno de chamada de notificação, o kernel:

  • Pré-alocar 64 WCHARs para Key.Buffer[]
  • Zero o buffer
  • Defina Key.MaximumLength como o tamanho do buffer em bytes e
  • Definir Key.Length = 0
Antes de sair da rotina de retorno de chamada, o PEP deve copiar uma cadeia de caracteres terminada em nulo para Key.Buffer e atualizar Key.Length com uma contagem de bytes que seja sizeof (WCHAR) vezes o número de caracteres UNICODE copiados, sem incluir o UNICODE_NULL de terminação.

O PEP deve usar a memória alocada apontada pelo endereço em Key.Buffer para fornecer a chave. Como essa memória é pré-alocada, seu tamanho não pode ser alterado. O PEP é responsável por truncar a cadeia de caracteres de chave, se necessário, para que ela não exceda o comprimento especificado em Key.MaximumLength (incluindo o caractere de UNICODE_NULL de terminação).

[in/out] Value

Um buffer para o PEP gravar a parte de valor do par de cadeia de caracteres de metadados.

Antes da entrada na rotina de retorno de chamada de notificação, o kernel:

  • Pré-alocar 64 WCHARs para Value.Buffer[]
  • Zero o buffer
  • Defina Value.MaximumLength como o tamanho do buffer em bytes e
  • Definir Value.Length = 0
Antes de sair da rotina de retorno de chamada, o PEP deve copiar uma cadeia de caracteres terminada em nulo em Value.Buffer e atualizar Value.Length com uma contagem de bytes que seja sizeof (WCHAR) vezes o número de caracteres UNICODE copiados, sem incluir o UNICODE_NULL de terminação.

O PEP deve usar a memória alocada apontada pelo endereço em Value.Buffer para fornecer o valor dos metadados. Como essa memória é pré-alocada, seu tamanho não pode ser alterado. O PEP é responsável por truncar a cadeia de caracteres de valor, se necessário, para que ela não exceda o comprimento especificado em Value.MaximumLength (incluindo o caractere de UNICODE_NULL de terminação).

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 10.
Cabeçalho pepfx.h (inclua Pep_x.h)

Confira também

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA