共用方式為


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_FLAGSDriverCompletesFStateTransition 已設定,但驅動程式未呼叫此函式,可能會發生死結。

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

另請參閱

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE