CDrawImage.FastRender 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 FastRender method draws the video image using the BitBlt or StretchBlt functions.

Syntax

void FastRender(
   IMediaSample *pMediaSample
);

Parameters

pMediaSample

Pointer to the IMediaSample interface of the sample that contains the image.

Return value

This method does not return a value.

Remarks

The CDrawImage::DrawImage method calls this method, but only if the allocator for the connection is a CImageAllocator object. In that case, the media sample is guaranteed to be a CImageSample object. The CImageSample object uses the CreateDIBSection function to allocate shared memory for the bitmap, which makes it possible to draw the image using either BitBlt or StretchBlt.

This method calls BitBlt if the source and targer rectangles exactly match, or StretchBlt otherwise.

If the filter does not own the allocator, the DrawImage method uses CDrawImage::SlowRender to draw the image.

Requirements

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

See also

CDrawImage Class