IRP_MN_SET_POWER

發行項
06/15/2023

此 IRP 會通知驅動程式變更系統電源狀態，或設定裝置的裝置電源狀態。

主要程式碼

IRP_MJ_POWER

傳送時

系統電源管理員或裝置電源原則擁有者可以傳送此 IRP。

電源管理員會傳送此 IRP 來通知驅動程式變更系統電源狀態。如果驅動程式已註冊其裝置以進行閒置偵測，電源管理員會傳送此 IRP 來變更閒置裝置的電源狀態。

擁有電源原則的驅動程式會傳送此 IRP 來設定其裝置的裝置電源狀態。驅動程式必須呼叫 PoRequestPowerIrp 以傳送此 IRP。

電源管理員會在 IRQL = PASSIVE_LEVEL將此 IRP 傳送至在 PDO 中設定DO_POWER_PAGABLE旗標的裝置堆疊。這類堆疊中的驅動程式可以觸碰分頁的程式碼或資料，以完成要求。

如果已設定DO_POWER_INRUSH旗標，電源管理員可以在 IRQL = DISPATCH_LEVEL傳送 IRP。這類驅動程式無法直接或間接存取任何分頁程式碼或資料。

輸入參數

Parameters.Power.Type成員會指定要設定的電源狀態類型，可以是SystemPowerState或DevicePowerState。

Parameters.Power.State成員會指定電源狀態本身，如下所示：

如果 Parameters.Power.Type 是 SystemPowerState，則此值為 SYSTEM_POWER_STATE 類型的列舉值。
如果 Parameters.Power.Type 為 DevicePowerState，則此值為 DEVICE_POWER_STATE 類型的列舉值。

Parameters.Power.ShutdownType成員會指定所要求轉換的其他資訊。這個成員的可能值 是POWER_ACTION 列舉值。如需詳細資訊，請參閱系統電源動作。

從 Windows Vista 開始， Parameters.Power.SystemPowerStateCoNtext 成員是唯讀、部分不透明 SYSTEM_POWER_STATE_CONTEXT 結構，其中包含電腦先前系統電源狀態的相關資訊。如果 Parameters.Power.Type 為 SystemPowerState 且 Parameters.Power.State 為 PowerSystemWorking，則此結構中的兩個旗標位會指出電腦是否進入 S0 (運作) 系統狀態。如需詳細資訊，請參閱區分快速啟動與喚醒與休眠。

下表顯示IRP_MN_SET_POWER的內容。Parameters.Power。{State|ShutdownType}和每個系統電源轉換之SYSTEM_POWER_STATE_CONTEXT結構中的CurrentSystemState、TargetSystemState和EffectiveSystemState位欄位。每個資料列都代表一個 IRP_MN_SET_POWER。

轉換	狀態	關機類型	目前 SystemState	目標 SystemState	有效的 SystemState	註解
睡眠...	S3	睡眠	S0	S3	S3
...喚醒	S0	睡眠	S3	S0	S0
混合式睡眠...	S4	休眠	S0	S3	S4	休眠檔案 (Fast S4)
...喚醒	S0	睡眠	S3	S0	S0
...Wake/PwrLost	S0	睡眠	S4	S0	S0
休眠至...	S4	休眠	S0	S4	S4
...喚醒	S0	睡眠	S4	S0	S0
混合式關機...	S4	休眠	S0	S5	S4	應用程式已關閉，使用者登出，就像關閉 (休眠開機)
...快速啟動	S0	睡眠	S4	S0	S0
關閉至...	S5	關機/重設/關閉	S0	S5	S5
...系統開機						沒有用於開機的 S-IRP

輸出參數

Parameters.Power.SystemCoNtext 保留供系統使用。

I/O 狀態欄塊

驅動程式會將 Irp-IoStatus.Status > 設定為 STATUS_SUCCESS，以指出裝置已進入要求的狀態。

驅動程式不得失敗要求來設定系統電源狀態。

位於匯流排驅動程式上方的函式和篩選驅動程式不得失敗，無法要求設定裝置電源狀態。如果裝置已移除或正在移除，匯流排驅動程式可能會失敗裝置電源要求。

作業

電源管理員或驅動程式可以要求 IRP_MN_SET_POWER IRP。電源管理員會基於下列其中一個原因傳送此 IRP：

通知驅動程式變更系統電源狀態
變更電源管理員執行閒置偵測的裝置電源狀態
若要在驅動程式在系統電源狀態的 IRP_MN_QUERY_POWER 要求失敗之後，使目前的系統狀態失效。如需詳細資訊，請參閱 IRP_MN_QUERY_POWER。

擁有裝置電源原則的驅動程式會傳送 IRP_MN_SET_POWER 來變更其裝置的電源狀態。

在任何指定的時間，系統只允許每個裝置物件使用一個這類 IRP。

每個驅動程式都必須呼叫 IoCallDriver (從 Windows Vista) 或 PoCallDriver (Windows Server 2003、Windows XP 和 Windows 2000) 開始，將每個電源 IRP 傳遞至下一個較低的驅動程式。 PoCallDriver介面類別似于IoCallDriver的介面，不同之處在于電源管理子系統可能會在將 IRP 傳遞至下一個驅動程式之前延遲 IRP。例如，如果裝置需要目前且必須以序列方式與另一個這類裝置一起啟動，則 PowerDeviceD0 要求可能會發生延遲。

驅動程式在 Windows Server 2003、Windows XP 或 Windows 2000 上收到IRP_MN_SET_POWER要求之後，驅動程式必須呼叫PoStartNextPowerIrp，如呼叫 PoStartNextPowerIrp中所述。從 Windows Vista 開始，不需要呼叫 PoStartNextPowerIrp ，這類呼叫不會執行電源管理作業。

系統電源狀態的IRP_MN_SET_POWER

只有系統電源管理員可以傳送系統設定電源 IRP。

驅動程式不得失敗要求來設定系統電源狀態。

可能的話，電源管理員會先傳送 IRP_MN_QUERY_POWER， 再傳送 IRP_MN_SET_POWER 要求系統睡眠狀態。不過，在某些情況下， (例如使用者按下電源關閉按鈕或電池過期) ，電源管理員可能會發出 IRP_MN_SET_POWER 而不先查詢。電源管理員只會查詢睡眠狀態;它永遠不會在啟動之前進行查詢。

IRP_MN_SET_POWER要求會傳送至裝置裝置堆疊中的頂端驅動程式。頂端驅動程式會將 IRP 向下傳遞至下一個較低的驅動程式，依此類推，直到 IRP 到達匯流排驅動程式為止，這必須完成 IRP。

篩選驅動程式通常不需要對系統集電源 IRP 採取行動，而不需將其傳遞。

不過，裝置電源原則擁有者會在傳遞 IRP 之前設定 IoCompletion 常式。在 IoCompletion 常式中，它會傳送裝置電源 IRP 的IRP_MN_SET_POWER 要求。如需詳細資訊，請參閱在裝置電源原則擁有者中處理系統Set-Power IRP。

系統設定電源 IRP 會通知驅動程式系統電源狀態的變更即將發生，而且驅動程式必須為其做好準備。不過，在驅動程式收到裝置電源狀態 的IRP_MN_SET_POWER 之前，驅動程式不應該變更 其裝置 的電源狀態。

Parameters.Power.ShutdownType上的值會提供有關擱置動作的其他資訊。當 IRP 指定 PowerSystemShutdown (S5) 時，驅動程式可以判斷系統是否重設 (PowerActionShutdownReset) ，或無限期關閉電源，以在稍後 (PowerActionShutdownOff) 重新開機 。對於大部分裝置的驅動程式而言，差異在於不區分。不過，對於某些裝置，例如視訊串流裝置，驅動程式可能會關閉裝置電源，以便在系統重設時停止 I/O。

在 Windows 2000 和更新版本的作業系統上， ShutdownType 的值也可以是 PowerActionShutdown。在此情況下，驅動程式無法分辨所要求的關機類型，因此應該繼續進行重設。

裝置電源狀態

驅動程式必須先將裝置設定為要求的狀態，才能完成 IRP。

當 IRP 要求轉換至較低電源狀態時，驅動程式必須處理 IRP，因為它會向下移動裝置堆疊，儲存驅動程式將需要還原到工作狀態的任何內容。在匯流排驅動程式收到 IRP 之後，驅動程式：

儲存驅動程式需要將裝置還原至工作狀態的任何內容。
將裝置設定為要求的電源狀態。
呼叫 PoSetPowerState 以通知電源管理員。
呼叫 PoStartNextPowerIrp 以啟動下一個 Power IRP (Windows Server 2003、Windows XP 和 Windows 2000 僅) 。
完成裝置電源 IRP。

驅動程式必須及時完成此 IRP。一般而言，驅動程式應該避免一般使用者發現明顯緩慢的任何延遲。例如，驅動程式可能會延遲系統狀態變更來排清快取的磁片或網路資料，但不應該讓網路連線保持運作或格式化磁帶。如需詳細資訊，請參閱傳遞 Power IRP。

在 Windows 2000 和更新版本的作業系統上，如果 IRP 指定 PowerDeviceD1、 PowerDeviceD2或 PowerDeviceD3，且系統設定電源 IRP 為使用中， 則 Parameters.Power.ShutdownType 的值會提供系統 IRP 的相關資訊。

休眠路徑上的裝置驅動程式應該檢查此值。如果 IRP 要求 PowerDeviceD3 和 ShutdownType 為 PowerActionHibernate，這類驅動程式應該儲存還原裝置所需的任何內容，但不應該關閉裝置電源;當電腦失去電源時，裝置會進入 D3 狀態。

在 Windows 2000 和更新版本的作業系統上，如果要求的電源狀態為PowerDeviceD0，驅動程式就不應該依賴ShutdownType的值。

在 Windows 98/Me 上，如果 IRP 要求裝置電源狀態， ShutdownType 一律為 PowerActionNone。

判斷何時關閉裝置的驅動程式會根據裝置類別而有所不同。

判斷何時啟動裝置的驅動程式幾乎一律是存取裝置註冊的驅動程式。驅動程式必須先確認裝置處於 D0 狀態，才能存取裝置的硬體暫存器。如果裝置不是處於 D0 狀態，驅動程式必須呼叫 PoRequestPowerIrp 以傳送 IRP 來啟動裝置。除非裝置處於 D0 狀態，否則驅動程式無法存取其裝置。

當驅動程式收到裝置狀態 D0 的設定電源 IRP 時，它會設定 IoCompletion 常式，並將 IRP 傳遞至下一個較低的驅動程式。

當 IRP 到達匯流排驅動程式時，該驅動程式會將 (或重設) 電源套用至裝置、呼叫 PoStartNextPowerIrp (Windows Server 2003、Windows XP 和 Windows 2000 僅) ，並呼叫 PoSetPowerState 通知電源管理員裝置的新電源狀態。

在匯流排驅動程式完成電源 IRP 之後，函式和篩選驅動程式會在其 IoCompletion 常式中處理 IRP，因為它會備份裝置堆疊。在 IoCompletion 常式中，每個驅動程式都會還原或重新初始化其裝置內容，並執行任何其他必要的啟動工作。

如需詳細資訊，請參閱處理裝置電源狀態的IRP_MN_SET_POWER。