Retrieves the current state of the media's timeline.

Syntax

HRESULT ITIMEMediaPlayer::get_state(TimeState *ts);

Parameters

ts

Pointer to a variable of type TimeState that receives one of the values listed in Possible Values.

Possible Values

0	Timeline is inactive.
1	Timeline is active.
2	Timeline is cueing the media file.
3	Timeline is seeking the specified point in the media file.
4	Timeline is holding on the current element, waiting for the parent element's timeline to end.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This property is only relevant for people who are writing a custom player for HTML+TIME (Timed Interactive Multimedia Extensions).