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 状态转换。
可以从多个执行线程同时调用此函数。 但是,一次只能有一个线程调用此函数来控制特定组件。
操作系统保证此函数遵循线程处理和同步零级别中定义的 零级别同步模式。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | 桌面 |
标头 | d3dkmddi.h |
IRQL | <=DISPATCH_LEVEL |