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 状态所需的上下文。

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

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

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

要求

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

另请参阅

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo