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 の呼び出しに失敗すると、バッファーに格納されたペイント操作ごとに内部データが初期化および破棄されるため、パフォーマンスが低下する可能性があります。

Requirements