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