Compartilhar via


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

Isso indica que uma parte da entrada de um efeito é inválida. Esse método pode ser chamado muitas vezes.

Você pode usar esse método para propagar retângulos inválidos por meio de um grafo de efeito. Você pode consultar Direct2D usando o método GetEffectInvalidRectangles.

Observe Direct2D não usa automaticamente esses retângulos inválidos para reduzir a região de um efeito renderizado.
 
Você também pode usar esse método para invalidar caches acumulados durante a renderização de efeitos que têm a propriedade D2D1_PROPERTY_CACHED definida como true.

Sintaxe

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

Parâmetros

[in] effect

Tipo: ID2D1Effect*

O efeito a ser invalidado.

input

Tipo: UINT32

O índice de entrada.

[in] inputRectangle

Tipo: const D2D1_RECT_F*

O rect a ser invalidado.

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.

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