Microsoft DirectX 8.1 (C++)

IDirectMusicTrack8::Clone

The Clone method makes a copy of a track.

Syntax

HRESULT Clone(
  MUSIC_TIME mtStart,
  MUSIC_TIME mtEnd,
  IDirectMusicTrack** ppTrack
 );

Parameters

mtStart

Start of the part to copy. It should be 0 or greater and less than the length of the track.

mtEnd

End of the part to copy. It should be greater than mtStart and less than the length of the track.

ppTrack

Address of a variable that receives a pointer to the created track, if successful.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the error values shown in the following table.

Return code
E_FAIL
E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

Remarks

It is the caller's responsibility to call Release when finished with the track.

Requirements

  Header: Declared in dmplugin.h.

See Also