ID2D1Device1::SetRenderingPriority 方法 (d2d1_2.h)

设置在与设备关联的任何设备上下文上执行的 Direct2D 呈现操作的优先级。

语法

void SetRenderingPriority(
  D2D1_RENDERING_PRIORITY renderingPriority
);

参数

renderingPriority

类型: D2D1_RENDERING_PRIORITY

设备和关联上下文的所需呈现优先级。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 向返回函数传递了无效的参数。

备注

调用此方法会影响与设备关联的所有设备上下文的呈现优先级。 此方法可以随时调用,但不能保证在下一帧开始之前生效。 建议的用法是在 BeginDrawEndDraw 块之外调用此方法。 在绘图块中频繁循环使用此属性将有效地减少应用的任何限制的好处。

要求

   
最低受支持的客户端 Windows 8.1 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1_2.h
Library D2d1.lib
DLL D2d1.dll

另请参阅

ID2D1Device1