Platform SDK: DirectX |
The IDirectMusicPerformance::GetSegmentState method retrieves the currently playing primary segment state or the primary segment state that is playing at a given time.
HRESULT GetSegmentState( IDirectMusicSegmentState ** ppSegmentState, MUSIC_TIME mtTime );
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
DMUS_E_NOT_FOUND |
E_POINTER |
To get the currently playing segment state, pass the time returned by the IDirectMusicPerformance::GetTime method. The currently playing segment state represents the segment currently generating messages. Because of latency, the currently playing segment state is not necessarily the one being heard.
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.