Edit

Share via

CImageAllocator.CreateDIB method

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The CreateDIB method creates a GDI device-independent bitmap (DIB). The DIB is allocated in a shared mempory block, which eliminates a copy operation when the owning filter blits the image.

Syntax

HRESULT CreateDIB(
        LONG    InSize,
  [ref] DIBDATA &DibData
);

Parameters

InSize

Size of the bitmap.

DibData [ref]

Reference to a DIBDATA structure. The method fills in this structure with information about the DIB.

Return value

Returns S_OK if successful, or an error code otherwise.

Requirements

Requirement Value
Header
Winutil.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CImageAllocator Class

CImageAllocator::Alloc