ID2D1EffectImpl::Initialize-Methode (d2d1effectauthor.h)
Der Effekt kann diese Methode verwenden, um einmal Initialisierungsaufgaben auszuführen. Wenn diese Methode nicht benötigt wird, kann die Methode einfach S_OK zurückgeben.
Syntax
HRESULT Initialize(
[in] ID2D1EffectContext *effectContext,
[in] ID2D1TransformGraph *transformGraph
);
Parameter
[in] effectContext
Typ: ID2D1EffectContext*
Eine interne Kontextschnittstelle, die effektorientierte Autorentypen erstellt und zurückgibt.
[in] transformGraph
Typ: ID2D1TransformGraph*
Der Effekt kann das Transformationsdiagramm mit einer Topologie auffüllen und später aktualisieren.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Dadurch werden die Kosten für die Ressourcenerstellung auf den CreateEffect-Aufruf verschoben und nicht während des Renderns.
Wenn bei der Implementierung dieser Aufruf fehlschlägt, schlägt auch der entsprechende ID2D1DeviceContext::CreateEffect-Aufruf fehl.
Das folgende Beispiel zeigt einen Effekt, der eine Initialisierungsmethode implementiert.
Beispiele
Das hier gezeigte Beispiel zeigt einen Effekt, der eine Initialisierungsmethode implementiert.
class CEffectImplementation : public ID2D1EffectImpl
{
public:
virtual ~CEffectImplementation()
{
if (_pContextInternal != NULL)
{
_pContextInternal->Release();
}
}
IFACEMETHODIMP Initialize(__in ID2D1DeviceContextInternal *pContextInternal, __in ID2D1TransformGraph *pTransformGraph)
{
HRESULT hr = S_OK;
_pContextInternal = pContextInternal;
_pContextInternal->AddRef();
_pTransformGraph = pTransformGraph;
_pTransformGraph>AddRef();
// Populate the transform graph.
return S_OK;
}
private:
ID2D1EffectContext *_pContextInternal;
ID2D1TransformGraph *_pTransformGraph;
};
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 |