ID2D1EffectImpl::SetGraph-Methode (d2d1effectauthor.h)

Der Renderer ruft diese Methode auf, um der Effektimplementierung eine Möglichkeit zum Angeben des Transformationsdiagramms und der Transformationsdiagrammänderungen bereitzustellen.

Der Renderer ruft diese Methode in folgenden Fällen auf:

• Wenn der Effekt zuerst initialisiert wird.
• Wenn sich die Anzahl der Eingaben für den Effekt ändert.

Syntax

HRESULT SetGraph(
  ID2D1TransformGraph *transformGraph
);

Parameter

transformGraph

Typ: ID2D1TransformGraph*

Das Diagramm, in dem der Effekt seine Transformationstopologie über den SetDescription-Aufruf beschreibt.

Rückgabewert

Typ: HRESULT

Ein Fehler, der verhindert, dass der Effekt initialisiert wird, wenn er als Teil des CreateEffect-Aufrufs aufgerufen wird. Wenn beim Effekt ein Fehler auftritt, wird ein nachfolgender SetGraph-Aufruf ausgeführt:

• Der Fehler wird von der Eigenschaftsmethode zurückgegeben, die bewirkt hat, dass sich die Anzahl der Eingaben für den Effekt ändert.
• Das Effektobjekt wird in einen Fehlerzustand versetzt. Wenn der Kontext anschließend zum Rendern verwendet wird, wird der Kontext in einen temporären Fehlerzustand versetzt. Dieser bestimmte Effekt kann nicht gerendert werden, und der Fehler wird beim nächsten EndDraw- oder Flush-Aufruf zurückgegeben.

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	d2d1effectauthor.h
Bibliothek	D2D1.lib

Weitere Informationen

ID2D1EffectImpl