ID2D1DeviceContext::InvalidateEffectInputRectangle-Methode (d2d1_1.h)

  • Artikel

Dies gibt an, dass ein Teil der Eingabe eines Effekts ungültig ist. Diese Methode kann mehrmals aufgerufen werden.

Sie können diese Methode verwenden, um ungültige Rechtecke über ein Effektdiagramm zu verteilen. Sie können Direct2D mithilfe der GetEffectInvalidRectangles-Methode abfragen.

Hinweis Direct2D verwendet diese ungültigen Rechtecke nicht automatisch, um den Bereich eines gerenderten Effekts zu reduzieren.
 
Sie können diese Methode auch verwenden, um Caches für ungültig zu erklären, die beim Rendern von Effekten angesammelt wurden, deren Eigenschaft D2D1_PROPERTY_CACHED auf true festgelegt ist.

Syntax

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

Parameter

[in] effect

Typ: ID2D1Effect*

Der effekt, der ungültig wird.

input

Typ: UINT32

Der Eingabeindex.

[in] inputRectangle

Typ: const D2D1_RECT_F*

Das zu ungültige Rechteck.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.

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