ID2D1DeviceContext::GetEffectRequiredInputRectangles-Methode (d2d1_1.h)

Gibt die Eingaberechtecke zurück, die vom Aufrufer angegeben werden müssen, um das angegebene Ausgaberechteck zu erzeugen.

Syntax

HRESULT GetEffectRequiredInputRectangles(
  [in]           ID2D1Effect                         *renderEffect,
  [in, optional] const D2D1_RECT_F                   *renderImageRectangle,
  [in]           const D2D1_EFFECT_INPUT_DESCRIPTION *inputDescriptions,
  [out]          D2D1_RECT_F                         *requiredInputRects,
                 UINT32                              inputCount
);

Parameter

[in] renderEffect

Typ: ID2D1Effect*

Das Bild, dessen Ausgabe gerendert wird.

[in, optional] renderImageRectangle

Typ: const D2D1_RECT_F*

Der Teil des Ausgabebilds, dessen Eingaben überprüft werden.

[in] inputDescriptions

Typ: const D2D1_EFFECT_INPUT_DESCRIPTION*

Eine Liste der Eingaben, deren Rechtecke abgefragt werden.

[out] requiredInputRects

Typ: D2D1_RECT_F*

Die Eingaberechtecke wurden an den Aufrufer zurückgegeben.

inputCount

Typ: UINT32

Die Anzahl der Eingaben.

Rückgabewert

Typ: HRESULT

Ein Fehlercode, der in der Regel nur darauf zurückzuführen ist, dass ein Effekt in der Kette einen Fehler zurückgegeben hat.

Hinweise

Der Aufrufer sollte sehr darauf achten, dass er sich nicht auf die zurückgegebenen erforderlichen Eingaberechtecke verlässt. Kleine Änderungen für die Richtigkeit des Verhaltens eines Effekts können dazu führen, dass unterschiedliche Rechtecke zurückgegeben werden. Darüber hinaus können verschiedene Arten von Optimierungen, die innerhalb des Renderns angewendet werden, das Ergebnis beeinflussen.

Anforderungen

Weitere Informationen

ID2D1DeviceContext