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

另请参阅

DXGI 接口

IDXGISurface1