Compartilhar via

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 de chave do par de cadeia de caracteres de metadados. key deve ser exclusivo entre todos os valores key relatados por esse subsistema.

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

  • Alocar previamente 64 WCHARs para Key.Buffer[]
  • Zero o buffer
  • Defina Key.MaximumLength com 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 Key.Buffer e atualizar Key.Length com uma contagem de bytes sizeof(WCHAR) vezes o número de caracteres UNICODE copiados, sem incluir o UNICODE_NULLde término.

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:

  • Alocar previamente 64 WCHARs para Value.Buffer[]
  • Zero o buffer
  • Defina Value.MaximumLength para 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 Value.Buffer e atualizar Value.Length com uma contagem de bytes sizeof(WCHAR) vezes o número de caracteres UNICODE copiados, sem incluir o UNICODE_NULLde término.

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
de cliente com suporte mínimo Com suporte a partir do Windows 10.
cabeçalho pepfx.h (inclua Pep_x.h)

Consulte também

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA