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 または次の値の任意の組み合わせを指定できます。

[in] pvBits

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

戻り値

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

解説

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

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

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

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

要件

関連項目

DrvCreateDeviceBitmap

EngAllocUserMem