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 パレットサーフェスを作成できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ddrawgdi.h |