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

Obtém os retângulos inválidos acumulados desde a última vez em que o efeito foi desenhado e EndDraw foi chamado no contexto do dispositivo.

Sintaxe

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

Parâmetros

[in] effect

Tipo: ID2D1Effect*

O efeito do qual obter os retângulos inválidos.

[out] rectangles

Tipo: D2D1_RECT_F*

Uma matriz de estruturas de D2D1_RECT_F . Você deve alocar isso para o tamanho correto. Você pode obter a contagem dos retângulos inválidos usando o método GetEffectInvalidRectangleCount .

[in] rectanglesCount

Tipo: UINT32

O número de retângulos a serem obtidos.

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 foi possível alocar memória suficiente para concluir a chamada.
E_INVALIDARG	Um parâmetro inválido foi passado para a função de retorno.

Comentários

Observe Direct2D não usa automaticamente esses retângulos inválidos para reduzir a região de um efeito renderizado.

 

Você pode usar o método InvalidateEffectInputRectangle para especificar retângulos invalidados para Direct2D propagar por meio de um grafo de efeito.

Se vários retângulos inválidos forem solicitados, os retângulos que esse método retorna poderão se sobrepor. Quando esse é o caso, a contagem de retângulos pode ser menor do que a contagem que GetEffectInvalidRectangleCount.

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
DLL	D2d1.dll

Confira também

ID2D1DeviceContext