Método ID2D1EffectContext::CreateEffect (d2d1effectauthor.h)

Crea un efecto Direct2D para el identificador de clase especificado. Esto es lo mismo que ID2D1DeviceContext::CreateEffect para que los efectos personalizados puedan crear otros efectos y encapsularlos en una transformación.

Sintaxis

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

Parámetros

effectId

Tipo: REFCLSID

Identificador de efecto integrado o registrado para crear el efecto. Consulte Efectos integrados para obtener una lista de identificadores de efecto.

[out] effect

Tipo: ID2D1Effect**

Cuando este método devuelve , contiene la dirección de un puntero al efecto.

Valor devuelto

Tipo: HRESULT

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

HRESULT	Descripción
S_OK	No se ha producido ningún error.
E_OUTOFMEMORY	Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_INVALIDARG	Se pasó un valor no válido al método .
D3DERR_OUTOFVIDEOMEMORY	Direct3D no tiene suficiente memoria para mostrar para realizar la operación.
D2DERR_EFFECT_IS_NOT_REGISTERED	El sistema no registra el efecto especificado.

Comentarios

El efecto creado no hace referencia al recuento del archivo DLL desde el que se creó el efecto. Si el autor de la llamada anula el registro de un efecto mientras se carga este efecto, el comportamiento resultante es imprevisible.

Requisitos

Cliente mínimo compatible	Windows 8 y Platform Update para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1effectauthor.h
Library	D2D1.lib

Consulte también

D2D1_BLEND_DESCRIPTION

Efectos

ID2D1BlendTransform

ID2D1EffectContext