IWDFDevice2::GetSystemPowerAction-Methode (wudfddi.h)

Artikel
07.02.2025

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die GetSystemPowerAction--Methode gibt die Systemleistungsaktion(falls vorhanden) zurück, die derzeit für den Computer ausgeführt wird.

Syntax

C++

POWER_ACTION GetSystemPowerAction();

Rückgabewert

GetSystemPowerAction- gibt einen POWER_ACTION-typed-Enumeratorwert zurück. Der Wert gibt die System-Energieaktion an, die derzeit für den Computer ausgeführt wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Mit der GetSystemPowerAction--Methode kann ein Treiber ermitteln, ob der Stromübergang eines Geräts auftritt, da das Gerät im Leerlauf (oder aufwachen) ist oder weil der gesamte Computer einen Energiesparzustand eingibt (oder verlässt).

Der Treiber muss GetSystemPowerAction nur von den Ereignisrückruffunktionen aufrufen, die das Framework aufruft, wenn das Gerät in einen Energiesparzustand oder zurück zum Arbeitszustand.

Der Wert, der GetSystemPowerAction zurückgibt, hängt von den folgenden Situationen ab:

Wenn der Computer einen Energiesparzustand eingibt, wenn der Treiber GetSystemPowerActionaufruft, gibt die Methode den Grund zurück, warum der Computer in den Energiesparmodus wechselt. Die Methode gibt z. B. PowerActionSleep- zurück, wenn der Computer seinen S1-, S2- oder S3-Energiesparzustand eingibt.
Wenn der Computer aus einem Energiesparzustand in den Arbeitszustand (S0) zurückkehrt, wenn der Treiber GetSystemPowerActionaufruft, gibt die Methode den Grund zurück, warum der Computer den Energiesparzustand eingegeben hat. Die Methode gibt z. B. PowerActionSleep- zurück, wenn der Computer seinen S1-, S2- oder S3-Energiesparzustand verlässt.
Wenn der Computer eingeschaltet wird (nachdem er ausgeschaltet wurde), wenn der Treiber GetSystemPowerActionaufruft, gibt die Methode PowerActionNonezurück.
Wenn das Gerät in einen Leerlaufzustand mit niedriger Leistung wechselt oder beim Aufrufen GetSystemPowerActionzurück zum Arbeitszustand (D0) wechselt, gibt die Methode PowerActionNonezurück.
Wenn sich der Computer und das Gerät in ihren Arbeitszuständen befinden, wenn der Treiber GetSystemPowerActionaufruft, gibt die Methode PowerActionNonezurück.

Weitere Informationen zu Energiesparzuständen finden Sie unter Ein Gerät gibt einen Low-Power Zustandein.

Beispiele

Im folgenden Codebeispiel wird die IWDFDevice2 Schnittstelle abgerufen und anschließend GetSystemPowerActionaufgerufen.

   IWDFDevice2 *pDevice2 = NULL;
    HRESULT hrQI = pDevice->QueryInterface(IID_PPV_ARGS(&pDevice2));
    if (SUCCEEDED(hrQI))
    {
        POWER_ACTION powerAction = pDevice2->GetSystemPowerAction();
    }
...
    SAFE_RELEASE(pDevice2);

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform-	Desktop
Mindest-UMDF-Version	1.9
Header-	wudfddi.h (include Wudfddi.h)
DLL-	WUDFx.dll

Siehe auch

IWDFDevice2-

Freigeben über