Metodo ID2D1DeviceContext::GetEffectRequiredInputRectangles (d2d1_1.h)

Articolo
02/24/2024

Restituisce i rettangoli di input necessari per essere forniti dal chiamante per produrre il rettangolo di output specificato.

Sintassi

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
);

Parametri

[in] renderEffect

Tipo: ID2D1Effect*

Immagine di cui viene eseguito il rendering dell'output.

[in, optional] renderImageRectangle

Tipo: const D2D1_RECT_F*

Parte dell'immagine di output i cui input vengono controllati.

[in] inputDescriptions

Tipo: const D2D1_EFFECT_INPUT_DESCRIPTION*

Elenco degli input i cui rettangoli vengono sottoposti a query.

[out] requiredInputRects

Tipo: D2D1_RECT_F*

I rettangoli di input restituiti al chiamante.

inputCount

Tipo: UINT32

Numero di input.

Valore restituito

Tipo: HRESULT

Un codice di errore, questo sarà in genere solo perché un effetto nella catena ha restituito un errore.

Commenti

Il chiamante deve essere molto attento a non posizionare una dipendenza dai rettangoli di input necessari restituiti. Le piccole modifiche per la correttezza del comportamento di un effetto possono comportare la restituzione di rettangoli diversi. Inoltre, diversi tipi di ottimizzazione applicati all'interno del rendering possono anche influenzare il risultato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_1.h
DLL	D2d1.dll

Vedi anche

ID2D1DeviceContext

Condividi tramite