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指定的電源元件索引。pInputData 在對 DxgkDdiQueryAdapterInfo 函式的呼叫中。
傳回值
無
備註
在元件註冊期間，顯示迷你埠驅動程式應該透過設定 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 (include D3dkmddi.h) |
| IRQL | <=DISPATCH_LEVEL |