PDXGK_FSTATE_NOTIFICATION回呼函式 (d3dkmthk.h)
由客戶端驅動程序實作以發出狀態通知。
語法
PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;
void PdxgkFstateNotification(
PVOID GraphicsDeviceHandle,
ULONG ComponentIndex,
UINT NewFState,
BOOLEAN PreNotification,
PVOID PrivateHandle
)
{...}
參數
GraphicsDeviceHandle
對圖形裝置進行回呼時,應該提供的不透明句柄。
ComponentIndex
元件的索引。 一般而言,這會是圖形配接器所使用的索引。 例外狀況是 LDA 案例,其中 ComponentIndex 的 HIWORD 表示配接器索引,如同在 LDA 案例中,圖形核心呼叫圖形驅動程式以進行 F 狀態變更時所完成。
NewFState
要轉換至的 F 狀態。
PreNotification
指出應該提供通知。
PrivateHandle
將在任何回呼中提供的不透明句柄。 此句柄必須是全域唯一的,因此應該使用呼叫驅動程式的 PDO 或 FDO 指標。
傳回值
無
備註
從 Dxgkrnl 到此回呼的所有回呼,最多可以呼叫DISPATCH_LEVEL (,例如,非圖形驅動程式不應該封鎖任何通知) 。 只會針對 DXGK_POWER_COMPONENT_SHARED 類型電源元件進行回呼。
在轉換 F 狀態之前,將會提供預先通知。 在圖形驅動程式的 DxgkCbCompleteFStateTransition 回呼中發出完成通知回呼 (PreNotification==FALSE) 。 也就是說,所有共用電源元件都會在傳回 DxgkCbCompleteFStateTransition 之前收到 F 狀態轉換完成的通知。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
最低支援的伺服器 | Windows Server 2012 |
標頭 | d3dkmthk.h |
IRQL | <= DISPATCH_LEVEL |