ID2D1DeviceContext::GetEffectInvalidRectangles メソッド (d2d1_1.h)
効果が最後に描画され、デバイス コンテキストで EndDraw が呼び出されてから累積された無効な四角形を取得します。
構文
HRESULT GetEffectInvalidRectangles(
[in] ID2D1Effect *effect,
[out] D2D1_RECT_F *rectangles,
[in] UINT32 rectanglesCount
);
パラメーター
[in] effect
種類: ID2D1Effect*
無効な四角形を取得する効果。
[out] rectangles
種類: D2D1_RECT_F*
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 |