Player.playState
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The playState property retrieves a value indicating the state of the Windows Media Player operation.
Syntax
player .playState
Possible Values
This property is a read-only Number (long). The C-style enumeration constant can be derived by prefixing the state value with "wmpps". For example, the constant for the Playing state is wmppsPlaying.
| Value | State | Description |
|---|---|---|
| 0 | Undefined | Windows Media Player is in an undefined state. |
| 1 | Stopped | Playback of the current media item is stopped. |
| 2 | Paused | Playback of the current media item is paused. When a media item is paused, resuming playback begins from the same location. |
| 3 | Playing | The current media item is playing. |
| 4 | ScanForward | The current media item is fast forwarding. |
| 5 | ScanReverse | The current media item is fast rewinding. |
| 6 | Buffering | The current media item is getting additional data from the server. |
| 7 | Waiting | Connection is established, but the server is not sending data. Waiting for session to begin. |
| 8 | MediaEnded | Media item has completed playback. |
| 9 | Transitioning | Preparing new media item. |
| 10 | Ready | Ready to begin playing. |
| 11 | Reconnecting | Reconnecting to stream. |
Remarks
Windows Media Player states are not guaranteed to occur in any particular order. Furthermore, not every state necessarily occurs during a sequence of events. You should not write code that relies upon state order.
Examples
The following JScript code shows the use of the player.playState property. An HTML text element, named "myText", displays the current status. The Player object was created with ID = "Player".
// Test whether Windows Media Player is in the playing state.
if (3 == Player.playState)
myText.value = "Windows Media Player is playing!";
else
myText.value = "Windows Media Player is NOT playing!";
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player version 7.0 or later. |
| DLL |
|