DXGKCB_SETPOWERCOMPONENTACTIVE回呼函式 (d3dkmddi.h)

發行項
02/23/2024

顯示迷你埠驅動程式會呼叫 DXGKCB_SETPOWERCOMPONENTACTIVE 來存取電源元件。此函式傳回之後，顯示迷你埠驅動程式可以變更元件的硬體設定。

語法

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

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

參數

[in] hAdapter

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

[in] ComponentIndex

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

傳回值

無

備註

對這個函式的每個呼叫都必須與 對DXGKCB_SETPOWERCOMPONENTIDLE 函式的呼叫配對，以指出不再需要元件硬體。

呼叫此函式時，元件的使用中參考計數會增加 1。 Power Management Framework 會維護參考計數，並且只有在參考計數變成零時，元件才會進入較低的 F 狀態。

呼叫此函式時，顯示迷你埠驅動程式可能會在另一個執行線程上收到 DxgkDdiSetPowerComponentFState 函式的呼叫。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。若要使用此回呼函式，請透過 DXGKRNL_INTERFACE 呼叫 DxgkCbSetPowerComponentActive。

規格需求

需求	值
最低支援的用戶端	Windows 8 (WDDM 1.2)
最低支援的伺服器	Windows Server 2012
目標平台	桌面
標頭	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL