Share via

CBaseControlVideo::GetCurrentImage

  • Article
 
Microsoft DirectShow 9.0

CBaseControlVideo::GetCurrentImage

The GetCurrentImage method retrieves a copy of the current image at the renderer.

Syntax

  HRESULT GetCurrentImage(
    long *pBufferSize,
    long *pVideoImage
);

Parameters

pBufferSize

Pointer to the size of the output buffer.

pVideoImage

Pointer to the output buffer for the image.

Return Value

Returns an HRESULT value that depends on the implementation; can be one of the following values, or other values not listed.

Value Description
E_FAIL Failure.
E_INVALIDARG Invalid argument.
E_OUTOFMEMORY Out of memory. Returned when the pVideoInfo parameter is NULL.
NOERROR Success.
VFW_E_NOT_PAUSED The operation could not be performed because the filter is not paused.

Remarks

This member function retrieves the image from the sample and copies it into the output buffer. The section of video copied into the output buffer reflects the source rectangle set through the IBasicVideo interface. It does not reflect the destination rectangle.

Requirements

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

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

See Also