CreateDIBitmap 関数 (wingdi.h)

  • [アーティクル]

CreateDIBitmap 関数は、DIB から互換性のあるビットマップ (DDB) を作成し、必要に応じてビットマップ ビットを設定します。

構文

HBITMAP CreateDIBitmap(
  [in] HDC                    hdc,
  [in] const BITMAPINFOHEADER *pbmih,
  [in] DWORD                  flInit,
  [in] const VOID             *pjBits,
  [in] const BITMAPINFO       *pbmi,
  [in] UINT                   iUsage
);

パラメーター

[in] hdc

デバイス コンテキストを識別するハンドル。

[in] pbmih

ビットマップ情報ヘッダー構造体へのポインター。 BITMAPV5HEADER。

fdwInit がCBM_INIT場合、関数はビットマップ情報ヘッダー構造を使用して、ビットマップの目的の幅と高さ、およびその他の情報を取得します。 高さの正の値はボトムアップ DIB を示し、高さの負の値はトップダウン DIB を示します。 CBM_INITとして fdwInit を使用して CreateDIBitmap を呼び出すことは、CreateCompatibleBitmap 関数を呼び出してデバイスの形式で DDB を作成し、SetDIBits 関数を呼び出して DIB ビットを DDB に変換することと同じです。

[in] flInit

システムがビットマップ ビットを初期化する方法を指定します。 次の値が定義されています。

値 説明
CBM_INIT
 このフラグが設定されている場合、システムは lpbInit パラメーターと lpbmi パラメーターが指すデータを使用してビットマップ ビットを初期化します。

このフラグが明確な場合、これらのパラメーターによって指されるデータは使用されません。
 

fdwInit が 0 の場合、システムはビットマップ ビットを初期化しません。

[in] pjBits

初期ビットマップ データを含むバイト配列へのポインター。 データの形式は、lpbmi パラメーターが指す BITMAPINFO 構造体の biBitCount メンバーによって異なります。

[in] pbmi

lpbInit パラメーターが指す配列の次元と色の形式を記述する BITMAPINFO 構造体へのポインター。

[in] iUsage

BITMAPINFO 構造体の bmiColors メンバーが初期化されたかどうかを指定し、初期化されている場合は、bmiColors に明示的な赤、緑、青 (RGB) 値またはパレット インデックスが含まれているかどうかを指定します。 fuUsage パラメーターは、次のいずれかの値である必要があります。

値 説明
DIB_PAL_COLORS
 カラー テーブルが提供され、ビットマップを選択するデバイス コンテキストの論理パレットに 16 ビット インデックスの配列で構成されます。
DIB_RGB_COLORS
 カラー テーブルが提供され、リテラル RGB 値が含まれています。

戻り値

関数が成功した場合、戻り値は互換性のあるビットマップへのハンドルです。

関数が失敗した場合は、返される値は NULL です。

解説

作成される DDB は、参照 DC のビット深度になります。 ビット深度が異なるビットマップを作成するには、 CreateDIBSection を使用します。

デバイスが最適なビットマップ描画速度に達するには、 fdwInit をCBM_INITとして指定します。 次に、ビデオ モードと同じ色深度 DIB を使用します。 ビデオが 4 または 8 bpp を実行している場合は、DIB_PAL_COLORSを使用します。

fdwInit パラメーターのCBM_CREATDIB フラグはサポートされなくなりました。

ビットマップが不要になったら、 DeleteObject 関数を呼び出して削除します。

Icm： カラー管理は実行されません。 結果のビットマップの内容は、ビットマップの作成後に色が一致しません。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目

BITMAPINFO

BITMAPINFOHEADER

ビットマップ関数

ビットマップの概要

CreateCompatibleBitmap

CreateDIBSection

DeleteObject

GetDeviceCaps

GetSystemPaletteEntries

Selectobject

SetDIBits