CMediaSample::GetMediaTime

Microsoft DirectShow 9.0

The GetMediaTime method retrieves the media times for this sample. This method implements the IMediaSample::GetMediaTime method.

Syntax

  HRESULT GetMediaTime(
    LONGLONG *pStart,
    LONGLONG *pEnd
);

Parameters

pStart

Pointer to a variable that receives the media start time.

pEnd

Pointer to a variable that receives the media stop time.

Return Value

Returns one of the HRESULT values shown in the following table.

Value	Description
S_OK	Success.
VFW_E_MEDIA_TIME_NOT_SET	No media times were set for this sample.

Remarks

The CMediaSample::m_MediaEnd member variable specifies an offset from CMediaSample::m_MediaStart, but the value received by the pEnd parameter is an absolute media time, calculated as m_MediaStart + m_MediaEnd.

For information about media times, see Time and Clocks in DirectShow.

Requirements

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

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

See Also

Additional resources