PEP_QUERY_COMPONENT_PERF_SET_NAME Struktur (pep_x.h)

Die PEP_QUERY_COMPONENT_PERF_SET_NAME-Struktur enthält Abfrageinformationen zu einer Reihe von Leistungsstatuswerten (P-Zustandssatz) für eine Komponente.

Syntax

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

Angehörige

[in] DeviceHandle

Ein PEPHANDLE-Wert, der das Gerät identifiziert. Der PEP hat dieses Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.

[in] Component

Der Index, der die Komponente identifiziert. Dieses Element ist ein Index im Components Array in der PEP_DEVICE_REGISTER_V2 Struktur, die der PEP zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[in] Set

Der Index, der diesen P-Zustandssatz identifiziert. Wenn diese Komponente M-P-Zustandssätze aufweist, reicht der P-Zustandssatz von 0 bis M-1. Der PEP hat zuvor die Anzahl der P-Zustandssätze als Reaktion auf eine PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES-Benachrichtigung angegeben.

[in, NameSize

Bei eingaben, die Größe des Puffers in Byte, auf den der Name Member verweist. Wenn Name NULL ist, überschreibt der PEP den Eingabewert von NameSize mit der für die Namenszeichenfolge erforderlichen Puffergröße.

[in] Name

Ein Zeiger auf einen Ausgabepuffer. Der PEP schreibt den Namen des P-Zustands in diesen Puffer. Der Name wird als Zeichenfolge mit breitem Zeichen und null beendeter Zeichenfolge gespeichert. Der Name Member ist NULL, wenn das Windows Power Management Framework (PoFx) bestimmen muss, wie groß ein Puffer für die Namenszeichenfolge zugeordnet werden soll. Wenn Name ungleich NULL ist, muss der Puffer groß genug sein, um die gesamte Zeichenfolge einschließlich des endenden Nullzeichens zu enthalten.

Bemerkungen

Diese Struktur wird von der PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME-Benachrichtigung verwendet. Die DeviceHandle, Componentund Set Member der Struktur enthalten Eingabewerte, die von PoFx beim Senden dieser Benachrichtigung bereitgestellt werden. Wenn der Name Member ungleich NULL ist, schreibt der PEP eine Zeichenfolge in den Puffer, auf den Nameverweist. Wenn Name NULL ist, schreibt PEP die erforderliche Puffergröße in das NameSize Member.

Die Zeichenfolge, die der PEP in den Ausgabepuffer schreibt, sollte einen beschreibenden Namen für den P-Zustandssatz enthalten. Dieser Name soll Protokolleinträge und Diagnosemeldungen leichter verständlich machen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Wird ab Windows 10 unterstützt.
Header-	pep_x.h (einschließen Pep_x.h)

Siehe auch

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE