DXGKDDISETPOWERCOMPONENTFSTATE 回呼函式 (d3dkmddi.h)

由 Microsoft DirectX 圖形核心子系統呼叫，將電源元件轉換為閑置狀態， (F 狀態) 。

語法

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

參數

DriverContext

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。

ComponentIndex

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

FState

顯示迷你埠驅動程式向 DirectX 圖形核心子系統回報的 F 狀態值。

傳回值

如果成功，則傳回STATUS_SUCCESS;否則會傳回STATUS_INVALID_PARAMETER。

備註

只有在顯示迷你埠驅動程式透過設定DXGK_DRIVERCAPS來指出支援時，操作系統才會呼叫 DxgkDdiSetPowerComponentFState。SupportRuntimePowerManagement 為 TRUE。

注意 若要避免可能的死結，請勿呼叫 DxgkCbSetPowerComponentActive 函式，直到此函式傳回為止。

 

當顯示器迷你埠驅動程式將電源元件從 F0 (完全開啟) 狀態轉換為另一個 F 狀態時，它應該儲存稍後將元件還原回 F0 狀態所需的內容。

Power Management Framework 只會將元件轉換至 F0 狀態或從該狀態轉換。

您可以從多個執行線程同時呼叫此函式。 不過，一次只能呼叫一個線程來控制特定元件。

操作系統保證此函式遵循 線程和同步處理零層級中所定義的零層級同步處理模式。

規格需求

需求	值
最低支援的用戶端	Windows 8
最低支援的伺服器	Windows Server 2012
目標平台	桌面
標頭	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL

另請參閱

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo