CMediaSample::GetTime

  • Article
 
Microsoft DirectShow 9.0

CMediaSample::GetTime

The GetTime method retrieves the stream times at which this sample should begin and finish. This method implements the IMediaSample::GetTime method.

Syntax

  HRESULT GetTime(
    REFERENCE_TIME *pTimeStart,
    REFERENCE_TIME *pTimeEnd
);

Parameters

pTimeStart

Pointer to a variable that receives the beginning stream time, in 100-nanosecond units.

pTimeEnd

Pointer to a variable that receives the ending stream time, in 100-nanosecond units. If the sample has no stop time, the value is set to the start time plus one.

Return Value

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

Value Description
S_OK Success.
VFW_S_NO_STOP_TIME Sample has a valid start time, but no stop time.
VFW_E_SAMPLE_TIME_NOT_SET Sample does not have valid time stamps.

Remarks

The CMediaSample::m_Start and CMediaSample::m_End member variables specify the time stamps. The CMediaSample::m_dwFlags member variable specifies whether the time stamps are valid.

For information about time stamps, 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