CDrawImage::DrawImage

 
Microsoft DirectShow 9.0

CDrawImage::DrawImage

The DrawImage method draws a video frame on the video window.

Syntax

  BOOL DrawImage(
    IMediaSample *pMediaSample
);

Parameters

pMediaSample

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

Return Value

No return value.

Remarks

This method delegates to CDrawImage::FastRender or CDrawImage::SlowRender, depending on whether the filter owns the allocator that provided the sample. If the filter does own the allocator, the sample is guaranteed to be a CImageSample object. In that case, the sample uses shared memory allocated by GDI, and the image can be drawn using either BitBlt or StretchBlt. Otherwise, the images must be drawn using the slower SetDIBitsToDevice or StretchDIBits functions. 

In debug builds, this method calls DisplaySampleTimes to draw the sample's time stamps over the video image.

Requirements

**  Header:** Declared in Winutil.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also