PoFxQueryCurrentComponentPerfState-Funktion (wdm.h)

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

Syntax

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

Die Parameter

[in] Handle

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

[in] Flags

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

[in] Component

Der Index, der die Komponente identifiziert, deren Leistungsstatus abgerufen wird. Dieser Parameter ist ein Index im Komponentenarray in der PO_FX_DEVICE Struktur, mit der der Gerätetreiber das Gerät bei PoFx registriert hat. Wenn das Komponentenarray N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[in] SetIndex

Der Index, der den Leistungsstatussatz angibt, dessen Leistung abgefragt wird. Dieser Parameter ist ein Index im PerfStateSets-Array in der PO_FX_COMPONENT_PERF_INFO Struktur, mit der der Gerätetreiber die Komponentenleistungszustände bei PoFx registriert. Wenn das PerfStateSets-Array N-Elemente enthält, reichen leistungszustandssatzindizes von 0 bis N-1.

[in] CurrentPerf

Ein Zeiger auf eine Variable, in der der aktuelle Leistungsstatus für den angegebenen Leistungszustandssatz zurückgegeben wird. Weitere Informationen zum zurückgegebenen Wert finden Sie in den Hinweisen.

Rückgabewert

PoFxQueryCurrentComponentPerfState gibt STATUS_SUCCESS zurück, wenn der angeforderte Vorgang erfolgreich ausgeführt wird. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.

Bemerkungen

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

• Bei einem Leistungsstatussatz, der eine fortlaufende Verteilung von Leistungszuständen darstellt, ist dies ein Wert zwischen den Membern "Minimum " und "Maximum " der PO_FX_COMPONENT_PERF_SET-Struktur .
• Bei einem Leistungsstatussatz, der eine diskrete Anzahl von Leistungszuständen darstellt, ist dieser Wert ein Index in den Mitgliedstaaten der PO_FX_COMPONENT_PERF_SET-Struktur .

Anforderungen

Siehe auch

Geräteleistungsstatusverwaltung

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates