BeginBufferedPaint 関数 (uxtheme.h)

バッファー処理されたペイント操作を開始します。

構文

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

パラメーター

hdcTarget

種類: HDC

バッファーが描画されるターゲット DC のハンドル。

prcTarget

型: const RECT*

描画するターゲット DC の領域を指定する RECT 構造体へのポインター。

dwFormat

種類: BP_BUFFERFORMAT

バッファーの形式を指定する BP_BUFFERFORMAT 列挙体のメンバー。

[in] pPaintParams

種類: BP_PAINTPARAMS*

ペイント操作パラメーターを定義する BP_PAINTPARAMS 構造体へのポインター。 この値には NULL を指定できます。

[out] phdc

種類: HDC*

この関数が戻るときに、新しいデバイス コンテキストのハンドルを指します。

戻り値

種類: HPAINTBUFFER

バッファーに格納されたペイント コンテキストへのハンドル。 この関数が失敗した場合、戻り値は NULL、 phdc は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

EndBufferedPaint が呼び出されると、返されたハンドルが解放されます。

アプリケーションは、BeginBufferedPaint を呼び出す前に呼び出し元スレッドで BufferedPaintInit を呼び出し、スレッドが終了する前に BufferedPaintUnInit を呼び出す必要があります。 BufferedPaintInit の呼び出しに失敗すると、バッファー処理されたペイント操作ごとに内部データが初期化および破棄されるため、パフォーマンスが低下する可能性があります。

要件