DXGKCB_SETPOWERCOMPONENTACTIVE回呼函式 (d3dkmddi.h)
顯示迷你埠驅動程式會呼叫 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 |