Freigeben über

PEP_SOC_SUBSYSTEM_METADATA Struktur (pepfx.h)

  • Artikel

Die PEP_SOC_SUBSYSTEM_METADATA-Struktur enthält Schlüsselwertpaare, die Metadaten für ein System auf einem Chip-Subsystem (SoC) enthalten. Sie 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;

Angehörige

[in/out] Key

Ein Puffer für den PEP zum Schreiben des Schlüsselteils des Metadatenzeichenfolgenpaars. Key- muss zwischen allen Key- Werten eindeutig sein, die von diesem Subsystem gemeldet werden.

Vor der Eingabe in die Benachrichtigungsrückrufroutine führt der Kernel folgende Aktionen aus:

  • Vorabzuweisung von 64 WCHARs für Key.Buffer[]
  • Null des Puffers
  • Legen Sie Key.MaximumLength- auf die Größe des Puffers in Bytes fest, und
  • Festlegen Key.Length = 0
Vor dem Beenden der Rückrufroutine muss die PEP eine mit Null beendete Zeichenfolge in Key.Buffer- kopieren und Key.Length- mit einer Byteanzahl aktualisieren, die Sizeof(WCHAR) Mal die Anzahl der kopierten UNICODE-Zeichen, nicht einschließlich der endenden UNICODE_NULL.

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

[in/out] Value

Ein Puffer für den PEP, um den Wertteil des Metadatenzeichenfolgenpaars zu schreiben.

Vor der Eingabe in die Benachrichtigungsrückrufroutine führt der Kernel folgende Aktionen aus:

  • Vorabzuweisung von 64 WCHARs für Value.Buffer[]
  • Null des Puffers
  • Legen Sie Value.MaximumLength- auf die Größe des Puffers in Bytes fest, und
  • Festlegen Wert.Length = 0
Vor dem Beenden der Rückrufroutine muss die PEP eine mit Null beendete Zeichenfolge in Value.Buffer- kopieren und Value.Length- mit einer Byteanzahl aktualisieren, die Sizeof(WCHAR) Mal die Anzahl der kopierten UNICODE-Zeichen, nicht einschließlich der beendeten UNICODE_NULL.

Der PEP muss den zugewiesenen Speicher verwenden, auf den die Adresse in Value.Buffer verweist, um den Metadatenwert bereitzustellen. Da dieser Speicher bereits zugeordnet ist, kann seine Größe nicht geändert werden. Der 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 endierenden UNICODE_NULL Zeichens).

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Wird ab Windows 10 unterstützt.
Header- pepfx.h (include Pep_x.h)

Siehe auch

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA