IDCompositionVirtualSurface::Trim 方法 (dcomp.h)

丢弃落在指定剪裁矩形之外的像素。

语法

HRESULT Trim(
  [in, optional] const RECT *rectangles,
  [in]           UINT       count
);

参数

[in, optional] rectangles

类型: const RECT*

要保留的矩形数组。

[in] count

类型: UINT

矩形数组中的 矩形 数。

返回值

类型: HRESULT

如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 DirectComposition 错误代码。

注解

虚拟表面可能没有足够的存储空间来容纳图面中的每个像素。 应用程序指示合成引擎通过调用 IDCompositionSurface::BeginDraw 方法为 Surface 分配内存,并通过调用 IDCompositionVirtualSurface::Trim 方法释放 Surface 的内存。 矩形数组表示在此方法返回后应保持分配的虚拟图面的区域。 指定矩形集之外的任何像素不再用于纹理,并且其内存可能会被回收。

如果 count 参数为零,则不保留任何像素,并且可能回收为虚拟图面分配的所有内存。 只有当 count 参数为零时,矩形参数才能为 NULL。

如果为此位图调用 IDCompositionSurface::BeginDraw 而不调用 IDCompositionSurface::EndDraw,此方法将失败。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

另请参阅

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize