ID2D1DeviceContext::InvalidateEffectInputRectangle メソッド (d2d1_1.h)

これは、効果の入力の一部が無効であることを示します。このメソッドは何度も呼び出すことができます。

このメソッドを使用すると、効果グラフを通じて無効な四角形を伝達できます。 Direct2D に対してクエリを実行するには、 GetEffectInvalidRectangles メソッドを使用します。

メモ Direct2D では、レンダリングされる効果の領域を減らすために、これらの無効な四角形が自動的に使用されることはありません。

また、このメソッドを使用して、 D2D1_PROPERTY_CACHED プロパティが true に設定されている効果のレンダリング中に蓄積されたキャッシュを無効にすることもできます。

構文

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

[in] effect

無効にする効果。

input

種類: UINT32

入力インデックス。

[in] inputRectangle

型: const D2D1_RECT_F*

無効化する修正。

種類: HRESULT

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

HRESULT	説明
S_OK	エラーは発生していません。
E_OUTOFMEMORY	Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。
E_INVALIDARG	返される関数に無効なパラメーターが渡されました。

要件	値
サポートされている最小のクライアント	Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d2d1_1.h
[DLL]	D2d1.dll