DXGKCB_SETPOWERCOMPONENTIDLE回呼函式 (d3dkmddi.h)

  • 發行項

顯示迷你埠驅動程式會 呼叫 DXGKCB_SETPOWERCOMPONENTIDLE ，以通知 DirectX 圖形核心子系統不再需要電源元件。 在此函式傳回之後，顯示迷你埠驅動程式不得變更元件的硬體設定。

語法

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

void DxgkcbSetpowercomponentidle(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

參數

[in] hAdapter

顯示配接器的句柄。 顯示迷你埠驅動程式會在呼叫其 DxgkDdiStartDevice 函式時，從 DXGKRNL_INTERFACE 結構的 DeviceHandle 成員接收句柄。

[in] ComponentIndex

DXGKARG_QUERYADAPTERINFO指定的電源元件索引。呼叫 DxgkDdiQueryAdapterInfo 函式中的 pInputData。

傳回值

無

備註

即使 DirectX 圖形核心子系統管理元件的閑置狀態，顯示器迷你埠驅動程式仍可針對任何類型的電源元件呼叫此函式。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。 若要使用此回呼函式，請透過 DXGKRNL_INTERFACE 呼叫 DxgkCbSetPowerComponentIdle。 對這個函式的每個呼叫都必須與 對 DXGKCB_SETPOWERCOMPONENTACTIVE 函式的呼叫配對。

呼叫此函式時，元件的使用中參考計數會減少 1。 只有在參考計數變成零時， Power Management Framework 才會維護參考計數，並將元件置於較低的 F 狀態。

此函式必須在 IRQL <= DISPATCH_LEVEL呼叫。 只有在元件類型 DXGK_POWER_COMPONENT_OTHER時，才能在 IRQL = DISPATCH_LEVEL呼叫。

規格需求

需求 值
最低支援的用戶端 Windows 8 (WDDM 1.2)
最低支援的伺服器 Windows Server 2012
目標平台 桌面
標頭 d3dkmddi.h (包含 D3dkmddi.h)
IRQL 請參閱一節。

另請參閱

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice