Método ID2D1DeviceContext::CreateEffect (d2d1_1.h)

  • Artículo

Crea un efecto para el identificador de clase especificado.

Sintaxis

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

Parámetros

effectId

Tipo: REFCLSID

Identificador de clase del efecto que se va a crear. 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 a un nuevo 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 memoria suficiente 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.
E_NOTFOUND Otros HRESULT posibles para un efecto que no se registra (como D2DERR_EFFECT_IS_NOT_REGISTERED).
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES El efecto requiere funcionalidades no compatibles con el dispositivo D2D.

Comentarios

Si el efecto creado es un efecto personalizado que se implementa en un archivo DLL, esto no incrementa el recuento de referencias de ese archivo DLL. Si la aplicación elimina un efecto mientras se carga ese efecto, el comportamiento resultante es imprevisible.

Requisitos

   
Cliente mínimo compatible Actualización de windows 8 y plataforma 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 d2d1_1.h
Archivo DLL D2d1.dll

Consulte también

Efectos

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect