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

Retorna as IDs de classe dos efeitos registrados no momento e os efeitos globais nessa fábrica.

Sintaxe

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

Parâmetros

[out] effects

Tipo: CLSID*

Quando este método retorna, contém uma matriz de efeitos. NULL se nenhum efeito for recuperado.

effectsCount

Tipo: UINT32

A capacidade da matriz de efeitos .

[out] effectsReturned

Tipo: UINT32*

Quando este método retorna, contém o número de efeitos copiados em efeitos.

[out, optional] effectsRegistered

Tipo: UINT32*

Quando esse método retorna, contém o número de efeitos registrados atualmente no sistema.

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.
E_OUTOFMEMORY Direct2D não pôde alocar memória suficiente para concluir a chamada.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) effectsRegistered é maior que effectCount.

Comentários

O conjunto de IDs de classe será retornado atomicamente pela API. O conjunto não será interrompido por outros threads registrando ou cancelando o registro de efeitos.

Se effectsRegistered for maior que effectCount, a matriz fornecida ainda será preenchida à capacidade com o conjunto atual de efeitos registrados. Esse método retorna os CLSIDs para todos os efeitos globais e todos os efeitos registrados nessa fábrica.

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::RegisterEffect