Compartilhar via

Método ID2D1Factory1::GetEffectProperties (d2d1_1.h)

  • Artigo

Recupera as propriedades de um efeito .

Sintaxe

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Parâmetros

[in] effectId

Tipo: REFCLSID

A ID do efeito do qual recuperar propriedades.

[out] properties

Tipo: ID2D1Propriedades**

Quando esse método retorna, contém o endereço de um ponteiro para a interface de propriedade que pode ser usado para consultar os metadados do efeito.

Retornar valor

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.
D2DERR_EFFECT_IS_NOT_REGISTERED Não foi possível encontrar o efeito solicitado.
E_OUTOFMEMORY Direct2D não pôde alocar memória suficiente para concluir a chamada.

Comentários

As propriedades de efeito retornadas terão todas as propriedades mutáveis para o efeito definidas como um padrão de NULL ou um valor vazio.

  • Os tipos de valor serão preenchidos com zero.
  • Os tipos de blob e cadeia de caracteres terão comprimento zero.
  • Os tipos de matriz terão comprimento 1 e o elemento da matriz estará em conformidade com as regras anteriores.
Esse método não pode ser usado para retornar as propriedades para qualquer efeito não visível para ID2D1DeviceContext::CreateEffect.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect