Platform SDK: DirectX |
The IDirectMusicSegment::SetLength method sets the length, in music time, of the segment. This method is usually called by the loader, which retrieves the segment length from the file and passes it to the segment object.
HRESULT SetLength( MUSIC_TIME mtLength );
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
E_INVALIDARG |
DMUS_E_OUT_OF_RANGE |
Neglecting to set a primary segment length can cause problems when cuing other primary segments with the DMUS_SEGF_QUEUE flag.
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.