ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Windows functions / MCI functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
MCIPosition (Function)
In french: MCIPosition
Returns or changes the current position in a media file previously opened (MCIOpen).
Example
MCIOpen("Sound.wav", "MySound")
...
MCIPlay("MySound")
...
MCIPosition("MySound", 10)
...
MCIClose("MySound")
Syntax

Modifying the position in the file Hide the details

<Result> = MCIPosition(<Media file or alias> , <Position> [, <Parameters> [, <Name of the message window>]])
<Result>: Boolean
  • True if the position was set,
  • False otherwise. To get the error number, use MCIErr.
    To get more details on the error, use MCIMsgErr or ErrorInfo with the errMessage constant.
    The status report of the command is returned by MCIRetrieve.
<Media file or alias>: Character string
Name of the media file to be used (AVI, MP3, etc.) or alias defined when opening the file (MCIOpen).
<Position>: Character string
New position in the file. This position is expressed in the format specified by MCIPositionFormat.
<Parameters>: Optional character string
Additional parameters if necessary. These parameters can be known by checking the documentation of the Windows MCI function named "seek".
The MciWait constant can be added to this string. This constant is used to indicate that the program must wait for the end of the MCI command to run the rest of application.
<Name of the message window>: Optional character string
Name of the window used to intercept and manage the different messages sent by MMSYSTEM.DLL. These messages are in MM_xxxxxx format and can be retrieved with Event. You can for example get messages regarding the management of the CD ROM or Joystick.

Finding out the position in the file Hide the details

<Result> = MCIPosition(<Media file or alias> [, <Name of the message window>])
<Result>: Character string
Position in the file. This position is expressed in the format specified by MCIPositionFormat.
<Media file or alias>: Character string
Name of the media file to be closed (AVI, MP3, etc.) or alias defined when opening the file (MCIOpen).
<Name of the message window>: Optional character string
Name of the window used to intercept and manage the different messages sent by MMSYSTEM.DLL. These messages are in MM_xxxxxx format and can be retrieved with Event. You can for example get messages regarding the management of the CD ROM or Joystick.
Remarks
Once MCIPosition has been called, to make sure that the position has been set, it is recommended to use the following line of code:
WHILE MCIStatus(<File or Alias>) <> MciStatusStop
END
Component: wd300std.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/02/2022

Send a report | Local help