IDirectMusicPerformance::Stop

The IDirectMusicPerformance::Stop method stops playback of one or more segments.

HRESULT Stop(
  IDirectMusicSegment* pSegment, 
  IDirectMusicSegmentState* pSegmentState, 
  MUSIC_TIME mtTime, 
  DWORD dwFlags
);
 

Parameters

pSegment

Segment to stop playing. All segment states based on this segment are stopped at mtTime. See Remarks.

pSegmentState

Segment state to stop playing. See Remarks.

mtTime

Time at which to stop the segment, segment state, or both. If the time is in the past, or 0 is passed in this parameter, the requested segments and segment states stop playing immediately.

dwFlags

Flag that indicates whether the stop should occur immediately at time mtTime, or on the grid, measure, or beat following mtTime. This is only valid in relation to the currently playing primary segment. (For flag descriptions, see DMUS_SEGF_FLAGS.)

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method may return E_POINTER.

Remarks

If pSegment and pSegmentState are both NULL, all music stops and all currently cued segments are released. If either pSegment or pSegmentState is not NULL, only the requested segment states are removed from the performance. If both are not NULL, and DMUS_SEGF_DEFAULT is used, the default resolution from the pSegment is used.

If you set all parameters to NULL or 0, everything stops immediately and controller reset messages and note-off messages are sent to all mapped PChannels.

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.