Partager via


IWMPSettings::setMode method

[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 setMode method sets the loop mode or shuffle mode to active or inactive.

Syntax

public void setMode(
  System.String bstrMode,
  System.Boolean varfMode
);

Public Sub setMode( _
  ByVal bstrMode As System.String, _
  ByVal varfMode As System.Boolean _
)
Implements IWMPSettings.setMode

Parameters

bstrMode [in]

A System.String that is the name of the mode being changed, containing one of the following values.

Value Description
autoRewind Tracks are restarted from the beginning after playing to the end.
loop The sequence of tracks repeats itself.
showFrame The nearest key frame is displayed when not playing. This mode is not relevant for audio tracks.
shuffle Tracks are played in random order.

varfMode [in]

A System.Boolean value specifying whether the new specified mode is active.

Return value

This method does not return a value.

Remarks

When the showFrame mode is active, Windows Media Player must access the track content to retrieve the video frame. Use this mode cautiously when playing content that is not local.

Requirements

Requirement Value
Version
Windows Media Player 9 Series or later
Namespace
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

See also

IWMPSettings Interface (VB and C#)

IWMPSettings.getMode (VB and C#)