Condividi tramite

PEP_SOC_SUBSYSTEM_METADATA struttura (pep_x.h)

  • Articolo

La struttura PEP_SOC_SUBSYSTEM_METADATA contiene coppie chiave-valore che contengono metadati per un sistema in un sottosistema SoC (Chip). Viene usato nel contesto di una notifica di PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA inviata a un plug-in di estensione della piattaforma (PEP).

Sintassi

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

Members

[in/out] Key

Buffer per il PEP per scrivere la parte chiave della coppia di stringhe di metadati. La chiave deve essere univoca tra tutti i valori chiave segnalati da questo sottosistema.

Prima di accedere alla routine di callback di notifica, il kernel:

  • Pre-allocare 64 WCHAR per Key.Buffer[]
  • Zero il buffer
  • Impostare Key.MaximumLength sulle dimensioni del buffer in byte e
  • Impostare Key.Length = 0
Prima di uscire dalla routine di callback, il PEP deve copiare una stringa con terminazione null in Key.Buffer e aggiornare Key.Length con un conteggio di byte che è sizeof(WCHAR) volte il numero di caratteri UNICODE copiati, non incluso il UNICODE_NULL terminazione.

Il PEP deve usare la memoria allocata a cui punta l'indirizzo in Key.Buffer per specificare la chiave. Poiché questa memoria è pre-allocata, le dimensioni non possono essere modificate. Il PEP è responsabile della troncatura della stringa di chiave, se necessario, in modo che non superi la lunghezza specificata in Key.MaximumLength (incluso il carattere di terminazione UNICODE_NULL ).

[in/out] Value

Buffer per il PEP per scrivere la parte valore della coppia di stringhe di metadati.

Prima di accedere alla routine di callback di notifica, il kernel:

  • Pre-allocare 64 WCHAR per Value.Buffer[]
  • Zero il buffer
  • Impostare Value.MaximumLength sulle dimensioni del buffer in byte e
  • Impostare Value.Length = 0
Prima di uscire dalla routine di callback, il PEP deve copiare una stringa con terminazione null in Value.Buffer e aggiornare Value.Length con un conteggio di byte che è sizeof(WCHAR) volte il numero di caratteri UNICODE copiati, non incluso il UNICODE_NULL terminazione.

Il PEP deve usare la memoria allocata a cui punta l'indirizzo in Value.Buffer per fornire il valore dei metadati. Poiché questa memoria è pre-allocata, le dimensioni non possono essere modificate. Il PEP è responsabile della troncatura della stringa di valore, se necessario, in modo che non superi la lunghezza specificata in Value.MaximumLength (incluso il carattere di terminazione UNICODE_NULL ).

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 10.
Intestazione pep_x.h (includere Pep_x.h)

Vedi anche

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA