Compartilhar via


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

Retorna os retângulos de entrada que precisam ser fornecidos pelo chamador para produzir o retângulo de saída fornecido.

Sintaxe

HRESULT GetEffectRequiredInputRectangles(
  [in]           ID2D1Effect                         *renderEffect,
  [in, optional] const D2D1_RECT_F                   *renderImageRectangle,
  [in]           const D2D1_EFFECT_INPUT_DESCRIPTION *inputDescriptions,
  [out]          D2D1_RECT_F                         *requiredInputRects,
                 UINT32                              inputCount
);

Parâmetros

[in] renderEffect

Tipo: ID2D1Effect*

A imagem cuja saída está sendo renderizada.

[in, optional] renderImageRectangle

Tipo: const D2D1_RECT_F*

A parte da imagem de saída cujas entradas estão sendo inspecionadas.

[in] inputDescriptions

Tipo: const D2D1_EFFECT_INPUT_DESCRIPTION*

Uma lista das entradas cujos retângulos estão sendo consultados.

[out] requiredInputRects

Tipo: D2D1_RECT_F*

Os retângulos de entrada retornados ao chamador.

inputCount

Tipo: UINT32

O número de entradas.

Retornar valor

Tipo: HRESULT

Um código de falha, isso normalmente só será porque um efeito na cadeia retornou algum erro.

Comentários

O chamador deve ter muito cuidado para não confiar nos retângulos de entrada necessários retornados. Pequenas alterações de correção no comportamento de um efeito podem resultar no retorno de retângulos diferentes. Além disso, diferentes tipos de otimização aplicados dentro da renderização também podem influenciar o resultado.

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