PDXGK_POWER_NOTIFICATION回呼函式 (d3dkmthk.h)
回呼,提供圖形裝置將經歷裝置電源狀態轉換的通知。
語法
PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;
void PdxgkPowerNotification(
PVOID GraphicsDeviceHandle,
DEVICE_POWER_STATE NewGrfxPowerState,
BOOLEAN PreNotification,
PVOID PrivateHandle
)
{...}
參數
GraphicsDeviceHandle
對圖形裝置進行回呼時,應該提供的不透明句柄。
NewGrfxPowerState
DEVICE_POWER_STATE 值,表示正在設定的新圖形電源狀態。
PreNotification
布爾值,指出是否應該提供通知。
PrivateHandle
任何回呼中提供的不透明句柄。 此句柄必須是全域唯一的,因此應該使用呼叫驅動程式 PDO 或 FDO 的指標。
傳回值
沒有
言論
此回呼是在 PASSIVE_LEVEL 進行。 只有在新的電源狀態為 PowerDeviceD3 時,驅動程式才能封鎖以完成作業的服務。 在此情況下,呼叫仍必須及時完成,因為它可以封鎖完成整體裝置電源狀態轉換,而且可能會造成電源監視程序錯誤檢查。 當新狀態為 PowerDeviceD0 時,驅動程式不得封鎖。 進入 PowerDeviceD3 時,會同時提供「前置」和「張貼」通知,假設過渡期間不會取消。 進入 PowerDeviceD0 時,只會提供「張貼」通知。 允許此回呼處理程序視需要呼叫 SetSharedPowerComponentStateCb 圖形回呼;此處理程式不允許其他圖形核心回呼。
重要
初始圖形電源狀態會在 IOCTL 輸出中提供,不過,由於圖形裝置可能會在註冊發生時經歷電源狀態轉換,因此必須在 IOCTL 呼叫和剖析原始狀態前後取得 Mutex,而且此回呼函式中必須取得相同的 Mutex。 如此一來,如果狀態正在轉換,回呼將會提供最新的狀態資訊。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 |
支援的最低伺服器 | Windows Server 2012 |
目標平臺 | 窗戶 |
標頭 | d3dkmthk.h |
IRQL | <= PASSIVE_LEVEL |