| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicSegment8::Clone
The Clone method copies all or part of the segment.
Syntax
HRESULT Clone(
MUSIC_TIME mtStart,
MUSIC_TIME mtEnd,
IDirectMusicSegment** ppSegment
);
Parameters
mtStart
Start of the part to copy. If this value is less than 0 or greater than the length of the segment, the segment is copied from the beginning.
mtEnd
End time of the part to copy. If this value is past the end of the segment, or 0, or less than mtStart, the segment is copied to the end.
ppSegment
Address of a variable that receives a pointer to the IDirectMusicSegment interface of the created segment. Use QueryInterface to obtain IDirectMusicSegment8. It is the caller's responsibility to call Release when finished with the segment.
Return Values
If the method succeeds, the return value is S_OK, or S_FALSE if some tracks failed to copy.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| E_OUTOFMEMORY |
| E_POINTER |
Remarks
Properties of the original segment, including start and loop points, number of repeats, and any toolgraph and default audiopath, are copied.
For
Requirements
Header: Declared in dmusici.h.
See Also
© 2004 Microsoft Corporation. All rights reserved.