CreateDIBSection

アプリケーションが直接書き込める DIB を作成する。

CreateDIBSection hdc, pbmi, usage, ppvBits, hSection, offset

hdc : [intptr] デバイスコンテキストへのハンドル。iUsage が DIB_PAL_COLORS の場合、この DC の論理パレットを使用して DIB の色を初期化する。
pbmi : [var] DIB の寸法や色などの属性を指定する BITMAPINFO 構造体へのポインタ。
usage : [int] pbmi が指す BITMAPINFO 構造体の bmiColors 配列メンバに格納されるデータの種類(論理パレットインデックスまたは RGB 値)。
ppvBits : [var] DIB ビット値の位置を指すポインタを受け取る変数へのポインタ。
hSection : [intptr] DIB の作成に使用するファイルマッピングオブジェクトへのハンドル。NULL を指定できる。NULL 以外の場合、CreateFileMapping を PAGE_READWRITE または PAGE_WRITECOPY フラグで作成したハンドルでなければならない。
offset : [int] hSection が参照するファイルマッピングオブジェクトの先頭からの、ビットマップビット値記憶位置のオフセット。hSection が NULL の場合は無視される。DWORD の倍数でなければならない。

(プラグイン / モジュール : gdi32.dll)

解説

アプリケーションが直接書き込める DIB を作成する。

[戻り値]
関数が成功した場合、戻り値は新しく作成された DIB へのハンドルで、*ppvBits はビットマップビット値を指す。失敗した場合は
NULL で *ppvBits も NULL。
（以下省略）

[備考]
hSection が NULL の場合、システムが DIB 用メモリを割り当てる。DeleteObject で DIB
を削除するとメモリも解放される。hSection が NULL でない場合、DeleteObject 後に自分で hSection
を閉じる必要がある。CreateDIBSection は BITMAPINFOHEADER の
biXPelsPerMeter/biYPelsPerMeter を使用せず、解像度情報を BITMAPINFO に提供しない。GDI
サブシステムが作成されたビットマップへの描画を完了するまで、自分で書き込む前に GdiFlush で同期する必要がある。ICM:
カラーマネジメントは行われない。

情報