Metodo ID2D1DeviceContext::InvalidateEffectInputRectangle (d2d1_1.h)

Ciò indica che una parte dell'input di un effetto non è valida. Questo metodo può essere chiamato molte volte.

È possibile usare questo metodo per propagare rettangoli non validi tramite un grafico degli effetti. È possibile eseguire query su Direct2D usando il metodo GetEffectInvalidRectangles .

Nota Direct2D non usa automaticamente questi rettangoli non validi per ridurre l'area di un effetto sottoposto a rendering.
 
È anche possibile usare questo metodo per invalidare le cache accumulate durante il rendering degli effetti che hanno la proprietà D2D1_PROPERTY_CACHED impostata su true.

Sintassi

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

Parametri

[in] effect

Tipo: ID2D1Effect*

Effetto per invalidare.

input

Tipo: UINT32

Indice di input.

[in] inputRectangle

Tipo: const D2D1_RECT_F*

Correzione per invalidare.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

HRESULT Descrizione
S_OK Non si sono verificati errori.
E_OUTOFMEMORY Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG Un parametro non valido è stato passato alla funzione restituita.

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