Método ID2D1DeviceContext::CreateEffect (d2d1_1.h)
Cria um efeito para a ID de classe especificada.
Sintaxe
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Parâmetros
effectId
Tipo: REFCLSID
A ID de classe do efeito a ser criado. 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 um novo 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. |
| E_NOTFOUND | Outro HRESULT possível para um efeito que não está sendo registrado (como D2DERR_EFFECT_IS_NOT_REGISTERED). |
| D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES | O efeito requer recursos sem suporte do dispositivo D2D. |
Comentários
Se o efeito criado for um efeito personalizado implementado em uma DLL, isso não incrementará a contagem de referência para essa DLL. Se o aplicativo excluir 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 | d2d1_1.h |
| DLL | D2d1.dll |