DdCreateDIBSection 関数 (ddrawgdi.h)

[この機能は、オペレーティング システムのリビジョンごとに変更される可能性があります。 代わりに、Microsoft DirectDraw と Microsoft Direct3DAPIs を使用します。これらの API は、このようなオペレーティング システムの変更からアプリケーションを保護し、ディスプレイ ドライバーとの直接対話に関連する他の多くの困難を隠します。

カラー テーブルをデバイスと共有する DIBSECTION 構造体を作成します。

GdiEntry9 は、この関数のエイリアスとして定義されます。

構文

HBITMAP DdCreateDIBSection(
  HDC              hdc,
  const BITMAPINFO *pbmi,
  UINT             iUsage,
  VOID             **ppvBits,
  HANDLE           hSectionApp,
  DWORD            dwOffset
);

パラメーター

hdc

現在のディスプレイ デバイスと互換性のある有効な DC。

pbmi

要求された DIBSECTION を記述する BITMAPINFO 構造体へのポインター。

iUsage

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

(DIB_PAL_COLORS)

bmiColors メンバーは、hdc で指定されたデバイス コンテキストの論理パレットに 16 ビット インデックスの配列です。

(DIB_RGB_COLORS)

BITMAPINFO 構造体には、リテラル RGB 値の配列が含まれています。

ppvBits

作成された DIBSECTION データへのポインターへのポインター。

hSectionApp

予約済み。 NULL にする必要があります。

dwOffset

戻り値

成功した場合、この関数は DIBSECTION を表すビットマップへのハンドルを返します。それ以外の場合は NULL を返します。

注釈

この関数を呼び出すと、ID パレットが保証され、 IDirectDrawSurface7::Blt または StretchBlt が呼び出されたときにパレット変換は行われません。

アプリケーションは IDirectDrawSurface7 を使用することをお勧めします。 IDirectDrawSurface7 は、オペレーティング システムに依存しない方法で 8 ビット/ピクセルの ID パレットサーフェスを作成できます。

要件

こちらもご覧ください

グラフィックス低レベルクライアントのサポート