ID2D1DeviceContext::InvalidateEffectInputRectangle-Methode (d2d1_1.h)

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