PoFxQueryCurrentComponentPerfState-Funktion (wdm.h)
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 |
|---|---|
|
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 .
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 |