Condividi tramite

struttura PEP_SOC_SUBSYSTEM_METADATA (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;

Membri

[in/out] Key

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

Prima di accedere alla routine di callback delle notifiche, il kernel eseguirà le operazioni seguenti:

  • Pre-allocare 64 WCHARs per Key.Buffer[]
  • Zero the 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 sizeof(WCHAR) volte il numero di caratteri UNICODE copiati, senza includere la terminazione UNICODE_NULL.

Il PEP deve usare la memoria allocata a cui punta l'indirizzo in Key.Buffer per fornire la chiave. Poiché la memoria è preallocata, le dimensioni non possono essere modificate. 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 delle notifiche, il kernel eseguirà le operazioni seguenti:

  • Prea allocare 64 WCHAR per Value.Buffer[]
  • Zero the buffer
  • Impostare Value.MaximumLength sulle dimensioni del buffer in byte e
  • Impostare Valore.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 sizeof(WCHAR) volte il numero di caratteri UNICODE copiati, senza includere il UNICODE_NULLdi terminazione .

Il PEP deve usare la memoria allocata a cui punta l'indirizzo in Value.Buffer per fornire il valore dei metadati. Poiché la memoria è preallocata, le dimensioni non possono essere modificate. 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).

Fabbisogno

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

Vedere anche

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA