BeginBufferedPaint, fonction (uxtheme.h)

Commence une opération de peinture mise en mémoire tampon.

Syntaxe

HPAINTBUFFER BeginBufferedPaint(
        HDC             hdcTarget,
        const RECT      *prcTarget,
        BP_BUFFERFORMAT dwFormat,
  [in]  BP_PAINTPARAMS  *pPaintParams,
  [out] HDC             *phdc
);

Paramètres

hdcTarget

Type : HDC

Handle du contrôleur de domaine cible sur lequel la mémoire tampon sera peinte.

prcTarget

Type : const RECT*

Pointeur vers une structure RECT qui spécifie la zone du contrôleur de domaine cible dans laquelle peindre.

dwFormat

Type : BP_BUFFERFORMAT

Membre de l’énumération BP_BUFFERFORMAT qui spécifie le format de la mémoire tampon.

[in] pPaintParams

Type : BP_PAINTPARAMS*

Pointeur vers une structure BP_PAINTPARAMS qui définit les paramètres d’opération de peinture. Cette valeur peut être NULL.

[out] phdc

Type : HDC*

Lorsque cette fonction est retournée, pointe vers le handle du nouveau contexte d’appareil.

Valeur retournée

Type : HPAINTBUFFER

Handle vers le contexte de peinture mis en mémoire tampon. Si cette fonction échoue, la valeur de retour est NULL et phdc a la valeur NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Le handle retourné est libéré lorsque EndBufferedPaint est appelé.

Une application doit appeler BufferedPaintInit sur le thread appelant avant d’appeler BeginBufferedPaint et BufferedPaintUnInit avant la fin du thread. L’échec de l’appel de BufferedPaintInit peut entraîner une dégradation des performances en raison de l’initialisation et de la destruction des données internes pour chaque opération de peinture mise en mémoire tampon.

Spécifications