Condividi tramite

struttura PEP_SOC_SUBSYSTEM_METADATA (pepfx.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, senza includere il UNICODE_NULL di terminazione.

Il PEP deve usare la memoria allocata a cui punta l'indirizzo in Key.Buffer per fornire la chiave. Poiché questa memoria è preallocata, non è possibile modificarne le dimensioni. Il PEP è responsabile del troncamento 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 del 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 numero di byte che è sizeof(WCHAR) volte il numero di caratteri UNICODE copiati, senza includere il UNICODE_NULL di 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 è preallocata, non è possibile modificarne le dimensioni. Il PEP è responsabile del troncamento della stringa del 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 pepfx.h (include Pep_x.h)

Vedi anche

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA