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的對應呼叫，這個方法就會失敗。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionDevice：：CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface：：Resize