IWDFDevice2：：GetSystemPowerAction 方法 （wudfddi.h）

[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱 開始使用 UMDF。]

GetSystemPowerAction 方法會傳回 系統電源動作，如果有的話，則為計算機。

語法

POWER_ACTION GetSystemPowerAction();

傳回值

GetSystemPowerAction 會傳回 POWER_ACTION型別列舉值。 值表示電腦目前發生 系統電源動作。 如需詳細資訊，請參閱下列一節。

言論

GetSystemPowerAction 方法可讓驅動程式判斷裝置的電源轉換是因為裝置閒置（或喚醒），還是因為整個電腦進入（或離開）低功率狀態而發生。

驅動程式必須只從架構 進入低功率 狀態時呼叫的事件回呼函式 GetSystemPowerAction，或 回到其工作狀態。

GetSystemPowerAction 傳回的值取決於下列情況：

• 如果當驅動程式呼叫 getSystemPowerAction 時，計算機進入低電源狀態時，此方法會傳回電腦進入低電源狀態的原因。 例如，如果計算機輸入 S1、S2 或 S3 低功率狀態，此方法會傳回 PowerActionSleep。
• 如果當驅動程式呼叫 GetSystemPowerAction時，計算機從低電源狀態返回其工作狀態 （S0） 狀態，此方法會傳回計算機進入低電源狀態的原因。 例如，如果電腦離開其 S1、S2 或 S3 低功率狀態，此方法會傳回 PowerActionSleep。
• 如果當驅動程式 GetSystemPowerAction時，電腦正在啟動電源（關閉之後），此方法會傳回 PowerActionNone。
• 如果當驅動程式呼叫 GetSystemPowerAction時，裝置進入低功率閑置狀態，或返回其工作狀態 （D0） 狀態，則方法會傳回 PowerActionNone。
• 如果當驅動程式呼叫 GetSystemPowerAction 時，電腦和裝置都處於其工作狀態，此方法會傳回 PowerActionNone。

如需低電源狀態的詳細資訊，請參閱 裝置進入 Low-Power 狀態。

例子

下列程式代碼範例會取得 IWDFDevice2 介面，然後呼叫 GetSystemPowerAction。

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

要求

要求	價值
終止支援	UMDF 2.0 和更新版本中無法使用。
目標平臺	桌面
最低 UMDF 版本	1.9
標頭	wudfddi.h （包括 Wudfddi.h）
DLL	WUDFx.dll

另請參閱

IWDFDevice2