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 |