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 パラメーターが 0 の場合、ピクセルは保持されません。また、仮想サーフェスに割り当てられたすべてのメモリを再利用できます。 rectangles パラメーターは、count パラメーターが 0 の場合にのみ NULL にすることができます。
このビットマップに対 して IDCompositionSurface::BeginDraw が呼び出された場合、 IDCompositionSurface::EndDraw への対応する呼び出しがない場合、このメソッドは失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |