ID2D1DeviceContext::GetEffectRequiredInputRectangles-Methode (d2d1_1.h)

  • Artikel

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

Weitere Informationen

ID2D1DeviceContext