BeginBufferedPaint-Funktion (uxtheme.h)

Startet einen gepufferten Malvorgang.

Syntax

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

Parameter

hdcTarget

Typ: HDC

Der Griff des Ziel-DC, auf dem der Puffer gemalt wird.

prcTarget

Typ: const RECT*

Ein Zeiger auf eine RECT-Struktur , der den Bereich des Ziel-DC angibt, in dem gezeichnet werden soll.

dwFormat

Typ: BP_BUFFERFORMAT

Ein Member der BP_BUFFERFORMAT-Enumeration , das das Format des Puffers angibt.

[in] pPaintParams

Typ: BP_PAINTPARAMS*

Ein Zeiger auf eine BP_PAINTPARAMS Struktur, die die Farbvorgangsparameter definiert. Dieser Wert kann NULL sein.

[out] phdc

Typ: HDC*

Wenn diese Funktion zurückgibt, zeigt auf das Handle des neuen Gerätekontexts.

Rückgabewert

Typ: HPAINTBUFFER

Ein Handle für den gepufferten Malkontext. Wenn diese Funktion fehlschlägt, ist der Rückgabewert NULL, und phdc ist NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Das zurückgegebene Handle wird freigegeben, wenn EndBufferedPaint aufgerufen wird.

Eine Anwendung sollte BufferedPaintInit im aufrufenden Thread aufrufen, bevor BeginBufferedPaintPaint und BufferedPaintUnInit aufgerufen wird, bevor der Thread beendet wird. Fehler beim Aufrufen von BufferedPaintInit können zu Leistungseinbußen führen, da interne Daten für jeden gepufferten Malvorgang initialisiert und zerstört werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
DLL	UxTheme.dll