FileNameSet Method (IMFile)

Allows you to:

Set file name of currently played file.
Seamlessly replace currently played file to another one.
Set next played file. It will be played after current file is finished.
Insert break to file playback: interrupt current file playback, play another file till the end and resume current file playback.
Set properties of the file.

Syntax

VB.Net
C#
Delphi
C++

Sub FileNameSet( _
   ByVal _bsFile As String, _
   ByVal _bsParam As String _
)

void FileNameSet( 
   string _bsFile,
   string _bsParam
)

procedure FileNameSet( 
    _bsFile: String;
    _bsParam: String
);

void FileNameSet( 
   BSTR* _bsFile,
   BSTR* _bsParam
)

Parameters

_bsFile: full file name (including full path)
_bsParam: string containing properties set by user (see MFile object: properties)

Example

Visual Basic
C#
Delphi

'Add file and configure file to be played from 10-th to 30-th second
m_objFile.FileNameSet(filename, "in=10 out=30")
'Add file and set it as next played file. It will be played after current file is finished.
m_objFile.FileNameSet(filename, "change_type=next")
'Replace currently played file with new one. In and Out points are saved.
m_objFile.FileNameSet(filename, "change_type=replace")
'Insert break to file playback: interrupt current file playback, play another file till the end and resume current file playback.
m_objFile.FileNameSet(filename, "change_type=break")
top break file playback and return to current file playback
m_objFile.FileNameSet("", "")
'Use external audio
m_objFile.FileNameSet(filename, "external_audio=c:\video.wav")

//Add file and configure file to be played from 10-th to 30-th second
m_objFile.FileNameSet(filename, "in=10 out=30");
//Add file and set it as next played file. It will be played after current file is finished.
m_objFile.FileNameSet(filename, "change_type=next");
//Replace currently played file with new one. In and Out points are saved.
m_objFile.FileNameSet(filename, "change_type=replace");
//Insert break to file playback: interrupt current file playback, play another file till the end and resume current file playback.
m_objFile.FileNameSet(filename, "change_type=break");
//Stop break file playback and return to current file playback
m_objFile.FileNameSet("", "");
//Use external audio
m_objFile.FileNameSet(filename, "external_audio=c:\video.wav");

//Add file and configure file to be played from 10-th to 30-th second
m_objFile.FileNameSet(filename, 'in=10 out=30');
//Add file and set it as next played file. It will be played after current file is finished.
m_objFile.FileNameSet(filename, 'change_type=next');
//Replace currently played file with new one. In and Out points are saved.
m_objFile.FileNameSet(filename, 'change_type=replace');
//Insert break to file playback: interrupt current file playback, play another file till the end and resume current file playback.
m_objFile.FileNameSet(filename, 'change_type=break');
//Stop break file playback and return to current file playback
m_objFile.FileNameSet('', '');
//Use external audio
m_objFile.FileNameSet(filename, 'external_audio=c:\video.wav');

Reference

IMFile Interface
IMFile Members