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

Article
08/22/2023

Obtient les rectangles non valides qui se sont accumulés depuis la dernière fois que l’effet a été dessiné et que EndDraw a ensuite été appelé dans le contexte de l’appareil.

Syntaxe

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

Paramètres

[in] effect

Type : ID2D1Effect*

Effet à partir duquel obtenir les rectangles non valides.

[out] rectangles

Type : D2D1_RECT_F*

Tableau de structures D2D1_RECT_F . Vous devez l’allouer à la taille appropriée. Vous pouvez obtenir le nombre de rectangles non valides à l’aide de la méthode GetEffectInvalidRectangleCount .

[in] rectanglesCount

Type : UINT32

Nombre de rectangles à obtenir.

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.

Remarques

Note Direct2D n’utilise pas automatiquement ces rectangles non valides pour réduire la région d’un effet rendu.

Vous pouvez utiliser la méthode InvalidateEffectInputRectangle pour spécifier des rectangles invalidés que Direct2D doit propager via un graphique d’effet.

Si plusieurs rectangles non valides sont demandés, les rectangles retournés par cette méthode peuvent se chevaucher. Dans ce cas, le nombre de rectangles peut être inférieur au nombre getEffectInvalidRectangleCount.

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

Partager via