Compartir a través de

Método ID2D1Factory1::RegisterEffectFromString (d2d1_1.h)

Registra un efecto dentro de la instancia de fábrica con el XML de propiedad especificado como una cadena.

Sintaxis

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

Parámetros

[in] classId

Tipo: REFCLSID

Identificador del efecto que se va a registrar.

[in] propertyXml

Tipo:PCWSTR de

Una lista de las propiedades, tipos y metadatos del efecto.

[in, optional] bindings

Tipo: const D2D1_PROPERTY_BINDING*

Matriz de propiedades y métodos.

Esto enlaza una propiedad por nombre a un método determinado implementado por el autor del efecto para controlar la propiedad. El nombre debe encontrarse en la propiedad correspondienteXml.

bindingsCount

Tipo: UINT32

Número de enlaces de la matriz de enlaces.

effectFactory

Tipo: PD2D1_EFFECT_FACTORY

Generador estático que se usa para crear el efecto correspondiente.

Valor devuelto

Tipo: HRESULT

El método devuelve un HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

HRESULT Descripción
S_OK No se produjo ningún error.
E_OUTOFMEMORY Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_INVALIDARG Se pasó un parámetro no válido a la función de devolución.

Observaciones

Los efectos direct2D deben definir sus propiedades en el momento del registro a través del XML de registro. Un efecto declara varias propiedades del sistema necesarias y también puede declarar propiedades personalizadas. Consulte efectos personalizados para obtener más información sobre el formato del parámetro propertyXml.

RegisterEffect es atómico y se cuenta la referencia. Para anular el registro de un efecto, llame a UnregisterEffect con el classId del efecto.

ImportanteregisterEffect no contiene una referencia al archivo DLL o ejecutable en el que se encuentra el efecto. La aplicación debe asegurarse de que la duración del archivo DLL o ejecutable contiene completamente todas las instancias de cada efecto registrado y creado.
 
Además de los efectos integrados que están registrados globalmente, esta API solo registra efectos para esta fábrica y las interfaces de contexto de dispositivo y dispositivo derivadas.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8 y Platform Update para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de d2d1_1.h
biblioteca de D2d1.lib
DLL de D2d1.dll

Consulte también

ID2D1Factory1 de

ID2D1Factory1::UnregisterEffect

  • Last updated on