Partager via


ID2D1DeviceContext ::InvalidateEffectInputRectangle, méthode (d2d1_1.h)

Cela indique qu’une partie de l’entrée d’un effet n’est pas valide. Cette méthode peut être appelée plusieurs fois.

Vous pouvez utiliser cette méthode pour propager des rectangles non valides via un graphique d’effets. Vous pouvez interroger Direct2D à l’aide de la méthode GetEffectInvalidRectangles .

Note Direct2D n’utilise pas automatiquement ces rectangles non valides pour réduire la région d’un effet rendu.
 
Vous pouvez également utiliser cette méthode pour invalider les caches qui ont été accumulés lors du rendu des effets dont la propriété D2D1_PROPERTY_CACHED a la valeur true.

Syntaxe

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

Paramètres

[in] effect

Type : ID2D1Effect*

Effet à invalider.

input

Type : UINT32

Index d’entrée.

[in] inputRectangle

Type : const D2D1_RECT_F*

Rect à invalider.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT Description
S_OK Aucune erreur ne s'est produite.
E_OUTOFMEMORY Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG Un paramètre non valide a été passé à la fonction de retour.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1_1.h
DLL D2d1.dll

Voir aussi

ID2D1DeviceContext