Compartir a través de

Función BeginBufferedPaint (uxtheme.h)

  • Artículo

Comienza una operación de pintura almacenada en búfer.

Sintaxis

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

Parámetros

hdcTarget

Tipo: HDC

Identificador del controlador de dominio de destino en el que se pintará el búfer.

prcTarget

Tipo: const RECT*

Puntero a una estructura RECT que especifica el área del controlador de dominio de destino en el que se va a pintar.

dwFormat

Tipo: BP_BUFFERFORMAT

Miembro de la enumeración BP_BUFFERFORMAT que especifica el formato del búfer.

[in] pPaintParams

Tipo: BP_PAINTPARAMS*

Puntero a una estructura BP_PAINTPARAMS que define los parámetros de operación de pintura. Este valor puede ser NULL.

[out] phdc

Tipo: HDC*

Cuando se devuelve esta función, apunta al identificador del nuevo contexto de dispositivo.

Valor devuelto

Tipo: HPAINTBUFFER

Identificador del contexto de pintura almacenado en búfer. Si se produce un error en esta función, el valor devuelto es NULL y phdc es NULL. Para obtener información de error extendida, llame a GetLastError.

El identificador devuelto se libera cuando se llama a EndBufferedPaint .

Una aplicación debe llamar a BufferedPaintInit en el subproceso que realiza la llamada antes de llamar a BeginBufferedPaint y BufferedPaintUnInit antes de que finalice el subproceso. Si no se llama a BufferedPaintInit , se puede reducir el rendimiento debido a que los datos internos se inicializan y destruyen para cada operación de pintura almacenada en búfer.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uxtheme.h
Archivo DLL UxTheme.dll