CImageAllocator.CreateImageSample method

[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 CreateImageSample method creates a media sample.

Syntax

virtual CImageSample* CreateImageSample(
   LPBYTE pData,
   LONG   Length
);

Parameters

pData

Pointer to a buffer of size Length, allocated by the caller.

Length

Length of the buffer.

Return value

Returns a CImageSample object.

Remarks

This method creates a new media sample, implemented as a CImageSample object. The sample's IMediaSample::GetPointer method returns a pointer to the buffer specified in the pData parameter.

If you derive a new allocator class from CImageAllocator and a new media sample class from CImageSample, you should override this method to create an instance of your media sample class.

Requirements

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

See also

CImageAllocator Class

CImageAllocator::Alloc