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，此方法将失败。

要求

另请参阅

IDCompositionDevice：：CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface：：Resize