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

効果が最後に描画され、デバイスコンテキストで EndDraw が呼び出されてから累積された無効な四角形を取得します。

構文

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

[in] effect

無効な四角形を取得する効果。

[out] rectangles

D2D1_RECT_F構造体の配列。これを正しいサイズに割り当てる必要があります。無効な四角形の数は、GetEffectInvalidRectangleCount メソッドを使用して取得できます。

[in] rectanglesCount

型: UINT32

取得する四角形の数。

型: HRESULT

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

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

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

InvalidateEffectInputRectangle メソッドを使用すると、Direct2D が効果グラフに反映される無効な四角形を指定できます。

複数の無効な四角形が要求された場合、このメソッドが返す四角形が重なることがあります。この場合、四角形の数が GetEffectInvalidRectangleCount のカウントよりも小さい場合があります。

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