共用方式為


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

另請參閱

DEVICE_POWER_STATE