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。SupportRuntimePowerManagementTRUE。

注意 为了避免可能的死锁，请不要在返回此函数之前调用 DxgkCbSetPowerComponentActive 函数。

 

当显示微型端口驱动程序将电源组件从 F0（完全打开）状态转换为另一个 F 状态时，它应保存稍后将组件还原回 F0 状态所需的上下文。

Power Management Framework 仅将组件转换到 F0 状态或从 F0 状态转换。

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

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

要求

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

另请参阅

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo