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 指示支持时,操作系统才会调用 DxgkDdiSetPowerComponentFStateSupportRuntimePowerManagementTRUE

注意 若要避免可能的死锁,请勿调用 DxgkCbSetPowerComponentActive 函数,直到此函数返回为止。
 
当显示微型端口驱动程序将电源组件从 F0 (完全处于) 状态转换为另一个 F 状态时,它应保存稍后将组件还原回 F0 状态所需的上下文。

电源管理框架仅将组件转换为或从 F0 状态转换。

可以从多个执行线程同时调用此函数。 但是,一次只能有一个线程调用此函数来控制特定组件。

操作系统保证此函数遵循线程处理和同步零级别中定义的 零级别同步模式。

要求

要求
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 桌面
标头 d3dkmddi.h
IRQL <=DISPATCH_LEVEL

另请参阅

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo