DdCreateDIBSection function (ddrawgdi.h)

Article
02/22/2024

[This function is subject to change with each operating system revision. Instead, use the Microsoft DirectDraw and Microsoft Direct3DAPIs; these APIs insulate applications from such operating system changes, and hide many other difficulties involved in interacting directly with display drivers.]

Creates a DIBSECTION structure that shares its color table with the device.

GdiEntry9 is defined as an alias for this function.

Syntax

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

Parameters

hdc

A valid DC compatible with the current display device.

pbmi

Pointer to a BITMAPINFO structure that describes the requested DIBSECTION.

iUsage

Specifies the type of data contained in the bmiColors array member of the BITMAPINFO structure pointed to by pbmi (either logical palette indexes or literal RGB values). The following values are defined.

(DIB_PAL_COLORS)

The bmiColors member is an array of 16-bit indexes into the logical palette of the device context specified by hdc.

(DIB_RGB_COLORS)

The BITMAPINFO structure contains an array of literal RGB values.

ppvBits

Pointer to a pointer to the created DIBSECTION data.

hSectionApp

Reserved. Must be NULL.

dwOffset

Return value

If successful, this function returns a handle to a bitmap representing the DIBSECTION; otherwise it returns NULL.

Remarks

Calling this function ensures an identity palette, and no palette conversion when IDirectDrawSurface7::Blt or StretchBlt are called.

Applications are advised to use IDirectDrawSurface7, which can create 8-bit-per-pixel, identity-paletted surfaces in a manner independent of the operating system.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ddrawgdi.h