IMediaSample::GetTime

Microsoft DirectShow 9.0

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

Syntax

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

Parameters

pTimeStart

[out] Pointer to a variable that receives the start time.

pTimeEnd

[out] Pointer to a variable that receives the stop time. If the sample has no stop time, the value is set to the start time plus one.

Return Values

Returns an HRESULT value. Possible values include those shown in the following table.

Return code	Description
S_OK	Success. The sample has valid start and stop times.
VFW_S_NO_STOP_TIME	The sample has a valid start time, but no stop time.
VFW_E_SAMPLE_TIME_NOT_SET	The sample is not time-stamped.

Remarks

Both time values are relative to the stream time. For more information, see Time and Clocks in DirectShow.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also

Additional resources