IDXGISurface1::ReleaseDC 方法 (dxgi.h)
(与当前图面关联的 DC) 释放 GDI 设备上下文,并允许使用 Direct3D 进行呈现。
语法
HRESULT ReleaseDC(
[in, optional] RECT *pDirtyRect
);
参数
[in, optional] pDirtyRect
类型: RECT*
指向 RECT 结构的指针,该结构标识图面脏区域。
脏区域是用于 GDI 呈现且要保留的图面的任何部分。
在某些情况下,此区域用作图形子系统的性能提示。
请勿使用此参数将呈现限制为指定的矩形区域。
如果传入 NULL,则 ReleaseDC 会将整个表面视为脏。
否则, ReleaseDC 使用 RECT 指定的区域作为性能提示来指示 GDI 呈现已操作的区域。
如果未更改任何内容,可以将指针传递到空 RECT 结构 (没有位置或区域) 矩形。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
Windows Vista 和 Windows Server 2008 中提供的 DXGI 1.0 不支持此方法。 DXGI 1.1 支持是必需的,在 Windows 7、Windows Server 2008 R2 上可用,并且作为 Windows Vista 的更新,Service Pack 2 (SP2 ) (KB 971644) 和 Windows Server 2008 (KB 971512) 。
使用 ReleaseDC 方法释放 DC 并指示应用程序已完成对此图面的所有 GDI 呈现。
必须先调用 ReleaseDC 方法,然后才能使用 Direct3D 执行其他呈现。
在调整缓冲区大小之前,必须释放所有未完成的 DC。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dxgi.h |
Library | DXGI.lib |