ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&) メソッド (d2d1_3.h)

このメソッドは、イメージソースキャッシュの設定された領域を、指定した四角形のみにトリミングします。

構文

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

[ref] rectangleToPreserve

型: const D2D1_RECT_U

イメージソースキャッシュに保持するイメージの領域をピクセル単位で指定します。四角形の外側にある領域は、キャッシュから削除されます。既定では、これは空の四角形です。つまり、イメージ全体がキャッシュから削除されます。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

指定されたリージョンは、イメージソースが描画されるスケールを含むように構築する必要があります。これらの座標は、ローカル座標で指定する必要があります。
つまり、DPI やその他の関連する変換 (ワールド変換やブラシ変換を含む) に従って API を呼び出す前に調整する必要があります。

イメージソースの作成時にオンデマンドキャッシュが要求されなかった場合、このメソッドは失敗します。

ID2D1Device::ClearResources と同様に、呼び出し元は、メモリ使用量を減らす前に、その後 D3D フラッシュを発行する必要があります。

この操作は、イメージソースが D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND オプションを使用して初期化されている場合にのみサポートされます。