共用方式為

IWDFDevice2：：GetSystemPowerAction 方法 (wudfddi.h)

  • 發行項

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

GetSystemPowerAction 方法會傳回計算機目前發生的系統電源動作。

Syntax

POWER_ACTION GetSystemPowerAction();

傳回值

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

備註

GetSystemPowerAction 方法可讓驅動程式判斷裝置的電源轉換是否因為裝置閑置 (或喚醒) ，或因為整部計算機進入 (或離開) 低電源狀態而發生。

驅動程式只能從架構進入低電源狀態或返回其工作狀態時所呼叫的事件回呼函式呼叫 GetSystemPowerAction。

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

  • 如果計算機在驅動程式呼叫 GetSystemPowerAction 時進入低電源狀態，此方法會傳回電腦進入低電源狀態的原因。 例如，如果計算機輸入其 S1、S2 或 S3 低電源狀態，此方法會傳回 PowerActionSleep 。
  • 如果計算機在驅動程式呼叫 GetSystemPowerAction 時，從低電源狀態返回其運作 (S0) 狀態，此方法會傳回電腦進入低電源狀態的原因。 例如，如果電腦離開其 S1、S2 或 S3 低電源狀態，此方法會傳回 PowerActionSleep 。
  • 如果計算機在驅動程式呼叫 GetSystemPowerAction 時關閉) 後 (電源，此方法會傳回 PowerActionNone。
  • 如果裝置進入低電源閑置狀態，或在驅動程式呼叫 GetSystemPowerAction 時返回其運作 (D0) 狀態，而其餘的系統仍維持在其運作 (S0) 狀態，此方法會傳回 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