Partager via

PEP_SOC_SUBSYSTEM_METADATA structure (pep_x.h)

  • Article

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 permettant au PEP d’écrire la partie clé de la paire de chaînes de métadonnées. La clé doit être unique parmi toutes les valeurs de clé signalées par ce sous-système.

Avant l’entrée dans la routine de rappel de notification, le noyau :

  • Pré-allouer 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 de taille (WCHAR) multiplié par le nombre de caractères UNICODE copiés, sans compter les UNICODE_NULL de fin.

Le pep doit utiliser la mémoire allouée qui est pointée vers 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 chargé de tronquer 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 le caractère UNICODE_NULL de fin).

[in/out] Value

Mémoire tampon permettant au PEP d’écrire la partie valeur de la paire de chaînes de métadonnées.

Avant l’entrée dans la routine de rappel de notification, le noyau :

  • Pré-allouer 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 de taille (WCHAR) multiplié par le nombre de caractères UNICODE copiés, sans compter les UNICODE_NULL de fin.

Le pep doit utiliser la mémoire allouée qui est pointée vers 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 chargé de tronquer 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 le caractère UNICODE_NULL de fin).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
En-tête pep_x.h (include Pep_x.h)

Voir aussi

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA