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 |