EngCreateBitmap

EngCreateBitmap 関数は、GDI にビットマップを作成・管理するよう要求する。

EngCreateBitmap sizl, lWidth, iFormat, fl, pvBits

sizl : [var] 作成するビットマップの幅と高さ（ピクセル単位）をメンバに含む SIZEL 構造体を指定する。SIZEL 構造体は SIZE 構造体と同一である。pvBits が NULL でない場合、この値はデバイス上で見えるすべてのピクセルを表すべきで、デバイスがオフスクリーンメモリを保持できるようにする。
lWidth : [int] ビットマップの割り当て幅を指定する。これは、ポインタを 1 走査線下に移動するために加える必要があるバイト数である。
iFormat : [int] 
fl : [int] 
pvBits : [intptr] 作成するビットマップの最初の走査線へのポインタ。NULL の場合、GDI はビットマップのピクセルのストレージ領域を割り当てる。NULL でなければ、ビットマップ用バッファへのポインタとなる。

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

解説

EngCreateBitmap 関数は、GDI にビットマップを作成・管理するよう要求する。

[戻り値]
関数が正常に完了した場合、戻り値は作成されたビットマップを識別するハンドルとなる。それ以外の場合、戻り値は 0
となる。EngCreateBitmap はエラーコードをログに記録しない。

[備考]
ビットマップ用ストレージはドライバが任意に提供できる。ドライバは DrvEnableSurface
から戻る前に、EngAssociateSurface
を呼んで作成したビットマップをサーフェスとして関連付けるべきである。ビットマップが不要になったら EngDeleteSurface
で削除する。フレームバッファディスプレイドライバは、GDI がディスプレイへ直接描画できるように pvBits
パラメータを使うべきである。

情報