PoFxQueryCurrentComponentPerfState-Funktion (wdm.h)

  • Artikel

Die PoFxQueryCurrentComponentPerfState-Routine ruft den aktiven Leistungszustand im Leistungszustandssatz einer Komponente ab.

Syntax

NTSTATUS PoFxQueryCurrentComponentPerfState(
  [in] POHANDLE   Handle,
  [in] ULONG      Flags,
  [in] ULONG      Component,
  [in] ULONG      SetIndex,
  [in] PULONGLONG CurrentPerf
);

Parameter

[in] Handle

Ein Handle, das die Registrierung des Geräts mit dem Power Management Framework (PoFx) darstellt. Der Gerätetreiber hat dieses Handle zuvor von der PoFxRegisterDevice-Routine erhalten.

[in] Flags

Auf 0 festlegen. Derzeit sind für diese Routine keine Flags definiert.

[in] Component

Der Index, der die Komponente identifiziert, deren Leistungszustand abgerufen wird. Dieser Parameter ist ein Index im Komponentenarray in der PO_FX_DEVICE Struktur, die der Gerätetreiber zum Registrieren des Geräts bei PoFx verwendet hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[in] SetIndex

Der Index, der den Leistungszustandssatz identifiziert, dessen Leistung abgefragt wird. Dieser Parameter ist ein Index im PerfStateSets-Array in der PO_FX_COMPONENT_PERF_INFO-Struktur , die der Gerätetreiber zum Registrieren der Komponentenleistungszustände bei PoFx verwendet hat. Wenn das PerfStateSets-Array N-Elemente enthält, reichen die Leistungszustandssatzindizes von 0 bis N–1.

[in] CurrentPerf

Ein Zeiger auf die Variable, in der der aktuelle Leistungszustand für den angegebenen Leistungszustandssatz zurückgegeben wird. Weitere Informationen zum zurückgegebenen Wert finden Sie unter Hinweise.

Rückgabewert

PoFxQueryCurrentComponentPerfState gibt STATUS_SUCCESS zurück, wenn der angeforderte Vorgang erfolgreich ist. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER
 Der Aufrufer hat einen ungültigen Index für den Komponenten- oder Komponentenstatussatz angegeben.

Hinweise

Ein Treiber kann die PoFxQueryCurrentComponentPerfState-Routine aufrufen, um den aktuellen Leistungszustand eines bestimmten Leistungszustands abzurufen, der für eine Komponente festgelegt ist. Wenn der Aufruf erfolgreich ist, wird der CurrentPerf-Parameter mit einem Zeiger auf einen Wert überschrieben, der den aktuellen Leistungszustand des Satzes angibt. Dieser Wert kann einer der folgenden sein, abhängig vom Inhalt der PO_FX_COMPONENT_PERF_SET Struktur, die der Treiber an die PoFxRegisterComponentPerfStates-Routine übergeben hat:

  • Für einen Leistungszustandssatz, der eine kontinuierliche Verteilung von Leistungszuständen darstellt, ist dies ein Wert zwischen den Membern Minimum und Maximum der PO_FX_COMPONENT_PERF_SET-Struktur .
  • Für einen Leistungszustandssatz, der eine diskrete Anzahl von Leistungszuständen darstellt, ist dieser Wert ein Index in das States-Element der PO_FX_COMPONENT_PERF_SET-Struktur .
Dieser Aufruf wird immer synchron ausgeführt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Ab Windows 10 verfügbar.
Zielplattform Universell
Header wdm.h
Bibliothek Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Weitere Informationen

Geräteleistungsstatusverwaltung

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates