PEP_QUERY_COMPONENT_PERF_SET_NAME-Struktur (pep_x.h)

  • Artikel

Die PEP_QUERY_COMPONENT_PERF_SET_NAME-Struktur enthält Abfrageinformationen zu einem Satz von Leistungszustandswerten (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;

Member

[in] DeviceHandle

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

[in] Component

Der Index, der die Komponente identifiziert. Dieser Member ist ein Index im Komponentenarray in der PEP_DEVICE_REGISTER_V2-Struktur , den pep zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[in] Set

Der Index, der diesen P-Zustandssatz identifiziert. Wenn diese Komponente über M P-Zustandssätze verfügt, reichen die P-Zustandssatzindizes 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 der Eingabe die Größe des Puffers in Bytes, auf den der Name-Member verweist. Wenn Name NULL ist, überschreibt PEP den Eingabewert von NameSize mit der Puffergröße, die für die Namenszeichenfolge erforderlich ist.

[in] Name

Ein Zeiger auf einen Ausgabepuffer. Pep schreibt den Namen des P-Zustands in diesen Puffer. Der Name wird als Zeichenfolge mit Breitzeichen und NULL-Termin 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 nicht NULL ist, muss der Puffer groß genug sein, um die gesamte Zeichenfolge einschließlich des abschließenden NULL-Zeichens zu enthalten.

Hinweise

Diese Struktur wird von der PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME Benachrichtigung verwendet. Die Member DeviceHandle, Component und Set der Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Wenn der Name-Member ungleich NULL ist, schreibt PEP eine Zeichenfolge in den Puffer, auf den der Name verweist. Wenn Name NULL ist, schreibt PEP die erforderliche Puffergröße in das NameSize-Element .

Die Zeichenfolge, die 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
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Kopfzeile pep_x.h (Pep_x.h einschließen)

Weitere Informationen

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE