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 方法，並呼叫 IDCompositionVirtualSurface：：Trim 方法來釋放介面的記憶體。 矩形的陣列代表應該在此方法傳回之後仍配置之虛擬表面的區域。 超出指定之矩形集外的任何圖元都不再用於紋理，而且可以回收其記憶體。

如果 count 參數為零，則不會保留任何圖元，而且可能會回收為虛擬表面配置的所有記憶體。 只有在 count 參數為零時，矩形參數才能為 NULL。

如果呼叫這個位圖的 IDCompositionSurface：：BeginDraw ，而沒有對 IDCompositionSurface：：EndDraw的對應呼叫，這個方法就會失敗。

規格需求

另請參閱

IDCompositionDevice：：CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface：：Resize