ID2D1Factory1::RegisterEffectFromString-Methode (d2d1_1.h)

Registriert einen Effekt innerhalb des Factory-instance mit der als Zeichenfolge angegebenen Eigenschafts-XML.

Syntax

HRESULT RegisterEffectFromString(
  [in]           REFCLSID                    classId,
  [in]           PCWSTR                      propertyXml,
  [in, optional] const D2D1_PROPERTY_BINDING *bindings,
                 UINT32                      bindingsCount,
                 const PD2D1_EFFECT_FACTORY  effectFactory
);

Parameter

[in] classId

Typ: REFCLSID

Der Bezeichner des zu registrierenden Effekts.

[in] propertyXml

Typ: PCWSTR

Eine Liste der Effekteigenschaften, -typen und -Metadaten.

[in, optional] bindings

Typ: const D2D1_PROPERTY_BINDING*

Ein Array von Eigenschaften und Methoden.

Dadurch wird eine Eigenschaft anhand des Namens an eine bestimmte Methode gebunden, die vom Effektautor implementiert wird, um die Eigenschaft zu behandeln. Der Name muss in der entsprechenden propertyXml gefunden werden.

bindingsCount

Typ: UINT32

Die Anzahl der Bindungen im Bindungsarray.

effectFactory

Typ: PD2D1_EFFECT_FACTORY

Die statische Factory, die zum Erstellen des entsprechenden Effekts verwendet wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Direct2D-Effekte müssen ihre Eigenschaften zum Zeitpunkt der Registrierung über registrierungs-XML definieren. Ein Effekt deklariert mehrere erforderliche Systemeigenschaften und kann auch benutzerdefinierte Eigenschaften deklarieren. Weitere Informationen zum Formatieren des propertyXml-Parameters finden Sie unter Benutzerdefinierte Effekte.

RegisterEffect ist sowohl atomisch als auch verweisgezählt. Um die Registrierung eines Effekts aufzuheben, rufen Sie UnregisterEffect mit der classId des Effekts auf.

Anforderungen

Weitere Informationen

ID2D1Factory1

ID2D1Factory1::UnregisterEffect