Função BeginBufferedPaint (uxtheme.h)

Inicia uma operação de pintura em buffer.

Sintaxe

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

Parâmetros

hdcTarget

Tipo: HDC

O identificador do DC de destino no qual o buffer será pintado.

prcTarget

Tipo: const RECT*

Um ponteiro para uma estrutura RECT que especifica a área do DC de destino na qual pintar.

dwFormat

Tipo: BP_BUFFERFORMAT

Um membro da enumeração BP_BUFFERFORMAT que especifica o formato do buffer.

[in] pPaintParams

Tipo: BP_PAINTPARAMS*

Um ponteiro para uma estrutura de BP_PAINTPARAMS que define os parâmetros de operação de pintura. Esse valor pode ser NULL.

[out] phdc

Tipo: HDC*

Quando essa função retorna, aponta para o identificador do novo contexto do dispositivo.

Valor de retorno

Tipo: HPAINTBUFFER

Um identificador para o contexto de pintura em buffer. Se essa função falhar, o valor retornado será NULL e phdc será NULL. Para obter informações de erro estendidas, chame GetLastError.

O identificador retornado é liberado quando EndBufferedPaint é chamado.

Um aplicativo deve chamar BufferedPaintInit no thread de chamada antes de chamar BeginBufferedPaint e BufferedPaintUnInit antes que o thread seja encerrado. A falha ao chamar BufferedPaintInit pode resultar em um desempenho degradado devido a dados internos sendo inicializados e destruídos para cada operação de pintura em buffer.

Requirements