Microsoft DirectX 8.1 (Visual Basic)

DirectMusicSegment8.SetStartPoint

The SetStartPoint method sets the point within the segment at which it starts playing in response to a call to the DirectMusicPerformance8.PlaySegmentEx method.

object.SetStartPoint(mtStart As Long)

Parts

object

Resolves to a DirectMusicSegment8 object.

mtStart

Point within the segment at which it is to start playing, in music time. Must be greater than or equal to zero and less than the length of the segment.

Error Codes

If the method fails, it raises an error, and Err.Number can be set to DMUS_E_OUT_OF_RANGE.

Remarks

By default, the start point is 0, meaning that the segment starts from the beginning.

The method does not affect any currently playing segment states created from this segment.

A segment that is reused might be loaded from an internal cache, in which case it will have the same start point it had the last time this value was set. It is a good idea to reset the start point to 0 before releasing a segment that might be played again.

See Also