EngCreateBitmap 関数 (winddi.h)

EngCreateBitmap 関数は、GDI がビットマップを作成および管理することを要求します。

構文

ENGAPI HBITMAP EngCreateBitmap(
       SIZEL sizl,
       LONG  lWidth,
  [in] ULONG iFormat,
  [in] FLONG fl,
  [in] PVOID pvBits
);

sizl

作成するビットマップの幅と高さをピクセル単位でメンバーに含む SIZEL 構造体を指定します。 SIZEL 構造体は SIZE 構造体と同じです。

pvBits が NULL でない場合、この値はデバイスに表示されているすべてのピクセルを表し、デバイスが画面外のメモリを保持できるようにします。

lWidth

ビットマップの割り当て幅を指定します。これは、1 つのスキャン行を下に移動するためにポインターに追加する必要があるバイト数です。

[in] iFormat

必要なピクセルあたりの色情報のビット数の観点からビットマップの形式を指定します。このパラメーターには、次のいずれかの値を指定できます。

[in] fl

作成するビットマップに関するプロパティを指定するビットマスクです。このパラメーターには、0 または次の値の任意の組み合わせを指定できます。

値	説明
BMF_NOZEROINIT	GDI は、割り当て時にビットマップをゼロ初期化しません。このフラグは、 pvBits が NULL の場合にのみチェックされます。
BMF_TOPDOWN	最初のスキャン行は、ビットマップの上部を表します。既定では、標準形式のビットマップの下部に最初のスキャン行があることに注意してください。
BMF_USERMEM	GDI は、ユーザーメモリからビットマップのメモリを割り当てます。既定では、メモリはカーネルのアドレス空間から割り当てられます。このフラグは、作成されるビットマップが他のプロセスで使用されない場合にのみ指定する必要があります。プリンタードライバーによってユーザーメモリを EngWritePrinter に渡すことはできません。

[in] pvBits

作成するビットマップの最初のスキャン行へのポインター。このパラメーターが NULL の場合、GDI はビットマップのピクセルの記憶域を割り当てます。 pvBits が NULL でない場合は、ビットマップのバッファーへのポインターです。

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

ビットマップのストレージは、必要に応じてドライバーによって提供できます。

ドライバーは、DrvEnableSurface から戻る前に EngAssociateSurface を呼び出して、作成したビットマップをサーフェスとして関連付ける必要があります。

必要なくなったら、 EngDeleteSurface を使用してビットマップを削除する必要があります。

フレームバッファーディスプレイドライバーでは pvBits パラメーターを使用する必要があります。これにより、GDI はほとんどの描画をディスプレイに直接実行できます。


サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	winddi.h (Winddi.h を含む)
Library	Win32k.lib
[DLL]	Win32k.sys