Freigeben über


PEP_SOC_SUBSYSTEM_METADATA-Struktur (pep_x.h)

Die PEP_SOC_SUBSYSTEM_METADATA-Struktur enthält Schlüssel-Wert-Paare, die Metadaten für ein System-on-a-Chip-Subsystem (SoC) enthalten. Es wird im Kontext einer PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA Benachrichtigung verwendet, die an ein Plattformerweiterungs-Plug-In (PEP) gesendet wird.

Syntax

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

Member

[in/out] Key

Ein Puffer für das PEP zum Schreiben des Schlüsselteils des Metadaten-Zeichenfolgenpaars. Der Schlüssel muss unter allen Schlüsselwerten , die von diesem Subsystem gemeldet werden, eindeutig sein.

Vor dem Einstieg in die Benachrichtigungsrückrufroutine führt der Kernel Folgendes aus:

  • Vorabzuweisung von 64 WCHARs für Key.Buffer[]
  • Puffer null
  • Legen Sie Key.MaximumLength auf die Größe des Puffers in Bytes fest, und
  • Key.Length = 0 festlegen
Vor dem Beenden der Rückrufroutine muss pep eine null-beendete Zeichenfolge in Key.Buffer kopieren und Key.Length mit einer Byteanzahl aktualisieren, die sizeof(WCHAR) mal die Anzahl der kopierten UNICODE-Zeichen ist, ohne die beendende UNICODE_NULL.

Der PEP muss den zugewiesenen Arbeitsspeicher verwenden, auf den die Adresse in Key.Buffer verweist, um den Schlüssel bereitzustellen. Da dieser Arbeitsspeicher vorab zugewiesen ist, kann seine Größe nicht geändert werden. Das PEP ist für das Abschneiden der Schlüsselzeichenfolge verantwortlich, falls erforderlich, sodass sie die in Key.MaximumLength angegebene Länge nicht überschreitet (einschließlich des beendenden UNICODE_NULL Zeichens).

[in/out] Value

Ein Puffer für das PEP zum Schreiben des Wertteils des Metadaten-Zeichenfolgenpaars.

Vor dem Einstieg in die Benachrichtigungsrückrufroutine führt der Kernel Folgendes aus:

  • Vorabzuweisung von 64 WCHARs für Value.Buffer[]
  • Puffer null
  • Legen Sie Value.MaximumLength auf die Größe des Puffers in Bytes fest, und
  • Wert.Length = 0 festlegen
Vor dem Beenden der Rückrufroutine muss pep eine null-beendete Zeichenfolge in Value.Buffer kopieren und Value.Length mit einer Byteanzahl aktualisieren, die sizeof(WCHAR) mal die Anzahl der kopierten UNICODE-Zeichen ist, ohne die beendende UNICODE_NULL.

Der PEP muss den zugewiesenen Arbeitsspeicher verwenden, auf den die Adresse in Value.Buffer verweist, um den Metadatenwert bereitzustellen. Da dieser Arbeitsspeicher vorab zugewiesen ist, kann seine Größe nicht geändert werden. Das PEP ist für das Abschneiden der Wertzeichenfolge verantwortlich, falls erforderlich, damit sie die in Value.MaximumLength angegebene Länge nicht überschreitet (einschließlich des beendenden UNICODE_NULL Zeichens).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Wird ab Windows 10 unterstützt.
Kopfzeile pep_x.h (einschließlich Pep_x.h)

Weitere Informationen

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA