CreateDIBSection 関数 (wingdi.h)

CreateDIBSection 関数は、アプリケーションが直接書き込むことができる DIB を作成します。 関数は、ビットマップ ビット値の位置へのポインターを提供します。 関数がビットマップの作成に使用するファイル マッピング オブジェクトにハンドルを指定することも、システムがビットマップのメモリを割り当てることもできます。

構文

HBITMAP CreateDIBSection(
  [in]  HDC              hdc,
  [in]  const BITMAPINFO *pbmi,
  [in]  UINT             usage,
  [out] VOID             **ppvBits,
  [in]  HANDLE           hSection,
  [in]  DWORD            offset
);

パラメーター

[in] hdc

デバイス コンテキストを識別するハンドル。 iUsage の値がDIB_PAL_COLORS場合、関数はこのデバイス コンテキストの論理パレットを使用して DIB 色を初期化します。

[in] pbmi

ビットマップの寸法や色など、DIB のさまざまな属性を指定する BITMAPINFO 構造体へのポインター。

[in] usage

pbmi が指す BITMAPINFO 構造体の bmiColors 配列メンバーに含まれるデータの型 (論理パレット インデックスまたはリテラル RGB 値)。 次の値が定義されています。

[out] ppvBits

DIB ビット値の場所へのポインターを受け取る変数へのポインター。

[in] hSection

DIB の作成に関数が使用するファイル マッピング オブジェクトへのハンドル。 このパラメーターは、NULL でもかまいません。

hSection が NULL でない場合は、PAGE_READWRITE または PAGE_WRITECOPY フラグを使用して CreateFileMapping 関数を呼び出すことによって作成されたファイル マッピング オブジェクトへのハンドルである必要があります。 読み取り専用 DIB セクションはサポートされていません。 他の方法で作成されたハンドルでは、 CreateDIBSection が失敗します。

hSection が NULL でない場合、CreateDIBSection 関数は、hSection によって参照されるファイル マッピング オブジェクト内のオフセット dwOffset にあるビットマップ ビット値を検索します。 アプリケーションは、後で CreateDIBSection によって返される HBITMAP を使用して GetObject 関数を呼び出すことによって、hSection ハンドルを取得できます。

hSection が NULL の場合、システムは DIB にメモリを割り当てます。 この場合、 CreateDIBSection 関数は dwOffset パラメーターを無視します。 アプリケーションは後でこのメモリへのハンドルを取得できません。 GetObject 関数を呼び出して入力された DIBSECTION 構造体の dshSection メンバーは NULL になります。

[in] offset

ビットマップ ビット値のストレージが開始される hSection によって参照されるファイル マッピング オブジェクトの先頭からのオフセット。 hSection が NULL の場合、この値は無視されます。 ビットマップ ビット値は doubleword 境界に配置されるため、 dwOffset は DWORD のサイズの倍数である必要があります。

戻り値

関数が成功した場合、戻り値は新しく作成された DIB へのハンドルであり、*ppvBits は ビットマップ ビット値を指します。

関数が失敗した場合、戻り値は NULL、*ppvBits は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

GetLastError は 次の値を返すことができます。

注釈

前述のように、 hSection が NULL の場合、システムは DIB にメモリを割り当てます。 後で DeleteObject 関数を呼び出して DIB を削除すると、システムはそのメモリへのハンドルを閉じます。 hSection が NULL でない場合は、DeleteObject を呼び出してビットマップを削除した後、hSection メモリ ハンドルを閉じる必要があります。

あるアプリケーションから別のアプリケーションに DIB セクションを貼り付けることはできません。

CreateDIBSection は BITMAPINFOHEADER パラメーター biXPelsPerMeter または biYPelsPerMeter を 使用せず、 BITMAPINFO 構造体に解決情報を提供しません。

自分でビットマップに描画する前に、GDI サブシステムが CreateDIBSection によって作成されたビットマップへの描画を完了していることを確認する必要があります。 ビットマップへのアクセスは同期する必要があります。 これを行うには、 GdiFlush 関数を呼び出します。 これは、 SetDIBits などの関数の呼び出しでポインターを渡すなど、ビットマップ ビット値へのポインターの使用に適用されます。

Icm： 色の管理は行われません。

要件

こちらもご覧ください

BITMAPINFO

ビットマップ関数

ビットマップの概要

CreateFileMapping

DIBSECTION

DeleteObject

GdiFlush

GetDIBColorTable

GetObject

SetDIBColorTable

SetDIBits