IDirectMusicSegmentState::GetStartTime

The IDirectMusicSegmentState::GetStartTime method gets the music time offset maintained by this segment state. This is the time, measured from the start of the performance, at which the segment started or will start playing.

HRESULT GetStartTime(
  MUSIC_TIME* pmtStart
);
 

Parameters

pmtStart
Address of a variable to receive the music time offset stored in this segment state.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method may return one of the following error values:

DMUS_E_BUFFER_EMPTY
E_POINTER

Remarks

If the segment was started from some point other than the beginning, this method returns the time at which play started minus the offset into the segment where play started. For example, if you played a segment at tick 5000 of the performance, and started from tick 1000 within the segment, the start time of the segment state would be 4000.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

IDirectMusicSegment::SetStartPoint, IDirectMusicSegment::GetStartPoint, IDirectMusicSegmentState::GetStartPoint