Método ID2D1EffectContext::CreateEffect (d2d1effectauthor.h)
Cria um efeito Direct2D para a ID de classe especificada. Isso é o mesmo que ID2D1DeviceContext::CreateEffect para que os efeitos personalizados possam criar outros efeitos e encapsule-os em uma transformação.
Sintaxe
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Parâmetros
effectId
Tipo: REFCLSID
A ID de efeito interna ou registrada para criar o efeito. Consulte Efeitos internos para obter uma lista de IDs de efeito.
[out] effect
Tipo: ID2D1Effect**
Quando esse método retorna, contém o endereço de um ponteiro para o efeito.
Valor retornado
Tipo: HRESULT
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| HRESULT | Descrição |
|---|---|
| S_OK | Não ocorreu nenhum erro. |
| E_OUTOFMEMORY | O Direct2D não pôde alocar memória suficiente para concluir a chamada. |
| E_INVALIDARG | Um valor inválido foi passado para o método . |
| D3DERR_OUTOFVIDEOMEMORY | O Direct3D não tem memória de exibição suficiente para executar a operação. |
| D2DERR_EFFECT_IS_NOT_REGISTERED | O efeito especificado não é registrado pelo sistema. |
Comentários
O efeito criado não faz referência à contagem da DLL da qual o efeito foi criado. Se o chamador cancelar o registro de um efeito enquanto esse efeito for carregado, o comportamento resultante será imprevisível.
Requisitos
| Cliente mínimo com suporte | Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d2d1effectauthor.h |
| Biblioteca | D2D1.lib |