PEP_QUERY_COMPONENT_PERF_SET_NAME-Struktur (pep_x.h)
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_DPM_QUERY_COMPONENT_PERF_CAPABILITIES