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

  • Artigo

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

Confira também

Efeitos

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect