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 |