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

另請參閱

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE