Método ID2D1DeviceContext::CreateEffect (d2d1_1.h)
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 |