DXGKCB_COMPLETEFSTATETRANSITION回呼函式 (d3dkmddi.h)
DXGKCB_COMPLETEFSTATETRANSITION 通知埠驅動程式電源元件已完成 F 狀態轉換。
語法
DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;
void DxgkcbCompletefstatetransition(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
參數
[in] hAdapter
顯示配接器的句柄。 顯示迷你埠驅動程式會從呼叫其 DxgkDdiStartDevice 函式的 DXGKRNL_INTERFACE 結構 DeviceHandle 成員接收句柄。
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFO所指定的電源元件索引。在呼叫 DxgkDdiQueryAdapterInfo 函式時,pInputData。
傳回值
沒有
言論
在元件註冊期間,顯示迷你埠驅動程式應該透過設定 DXGK_POWER_COMPONENT_FLAGS來指出它需要呼叫 DXGKCB_COMPLETEFSTATETRANSITION 函式的所有電源元件。DriverCompletesFStateTransition 成員為 1。 設定此成員時,驅動程式必須以同步或異步方式呼叫此函式。 相反地,如果未設定此成員,驅動程式就不應該呼叫此函式。
注意
如果 DXGK_POWER_COMPONENT_FLAGS。DriverCompletesFStateTransition 已設定,但驅動程式未呼叫此函式,可能會發生死結。
Windows 電源管理架構保證不會針對元件傳送任何新的轉換要求,直到呼叫此函式為止。
埠驅動程式通常會預期當此函式傳回時,F 狀態轉換已完成。 在某些情況下,顯示迷你埠驅動程式無法同步完成轉換,例如,如果顯示迷你埠驅動程式無法在 DISPATCH_LEVEL完成轉換,或它需要啟動其他電源元件。 此函式可協助顯示迷你埠驅動程式以異步方式完成 F 狀態轉換。
DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式,請設定 DXGKARGCB_ALLOCATEPAGESFORMDL 的成員,然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbCompleteFStateTransition 。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 (WDDM 1.2) |
支援的最低伺服器 | Windows Server 2012 |
目標平臺 | 桌面 |
標頭 | d3dkmddi.h (包括 D3dkmddi.h) |
IRQL | <=DISPATCH_LEVEL |