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 de l’opération de peinture. Cette valeur peut être NULL.

[out] phdc

Type : HDC*

Lorsque cette fonction retourne, pointe vers le handle du nouveau contexte d’appareil.

Valeur retournée

Type : HPAINTBUFFER

Handle du contexte de peinture mis en mémoire tampon. Si cette fonction échoue, la valeur de retour est NULL et phdc est NULL. Pour obtenir des informations détaillées sur l’erreur, 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 l’arrêt 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.

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uxtheme.h
DLL	UxTheme.dll