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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| DLL | D2d1.dll |