Partager via


structure PEP_SOC_SUBSYSTEM_METADATA (pep_x.h)

La structure PEP_SOC_SUBSYSTEM_METADATA contient des paires clé-valeur qui contiennent des métadonnées pour un système sur un sous-système de puce (SoC). Il est utilisé dans le contexte d’une notification PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA envoyée à un plug-in d’extension de plateforme (PEP).

Syntaxe

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

Membres

[in/out] Key

Mémoire tampon pour que le pep écrive la partie clé de la paire de chaînes de métadonnées. clé doit être unique parmi toutes les valeurs Key signalées par ce sous-système.

Avant d’entrer dans la routine de rappel de notification, le noyau :

  • Pré-allocation de 64 WCHAR pour Key.Buffer[]
  • Zéro de la mémoire tampon
  • Définissez key.MaximumLength sur la taille de la mémoire tampon en octets et
  • Définir Key.Length = 0
Avant de quitter la routine de rappel, le pep doit copier une chaîne terminée par null dans Key.Buffer et mettre à jour Key.Length avec un nombre d’octets sizeof(WCHAR) fois le nombre de caractères UNICODE copiés, sans inclure le UNICODE_NULLde fin.

Le point de terminaison privilégié doit utiliser la mémoire allouée pointée par l’adresse dans Key.Buffer pour fournir la clé. Étant donné que cette mémoire est pré-allouée, sa taille ne peut pas être modifiée. Le pep est responsable de la troncation de la chaîne de clé, si nécessaire, afin qu’elle ne dépasse pas la longueur spécifiée dans Key.MaximumLength (y compris la fin UNICODE_NULL caractère).

[in/out] Value

Mémoire tampon pour que le pep écrive la partie valeur de la paire de chaînes de métadonnées.

Avant d’entrer dans la routine de rappel de notification, le noyau :

  • Préalloue 64 WCHAR pour Value.Buffer[]
  • Zéro de la mémoire tampon
  • Définissez Value.MaximumLength sur la taille de la mémoire tampon en octets et
  • Définir Value.Length = 0
Avant de quitter la routine de rappel, le PEP doit copier une chaîne terminée par null dans Value.Buffer et mettre à jour Value.Length avec un nombre d’octets sizeof(WCHAR) fois le nombre de caractères UNICODE copiés, sans inclure le UNICODE_NULLde fin.

Le pep doit utiliser la mémoire allouée vers laquelle pointe l’adresse dans Value.Buffer pour fournir la valeur de métadonnées. Étant donné que cette mémoire est pré-allouée, sa taille ne peut pas être modifiée. Le pep est responsable de la troncation de la chaîne de valeur, si nécessaire, afin qu’elle ne dépasse pas la longueur spécifiée dans Value.MaximumLength (y compris la fin UNICODE_NULL caractère).

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge à partir de Windows 10.
d’en-tête pep_x.h (inclure Pep_x.h)

Voir aussi

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA