Copyright © 2005-2018 MultiMedia Soft

MediaFileDecoder.FileOpen method

Previous pageReturn to chapter overviewNext page

Remarks

 

Opens a media file with the purpose of decoding the audio track.

 

Supported media files can be separated in 3 main categories:

 

Media files supported natively :

 

- AAC

- M4A

- PAF

- AC3

- MOD Music

- PVF

- AIFF

- Monkey's Audio (APE)

- Speex

- ALAC

- MP3, MP2, MP1

- SVX

- AU

- MP4

- VOC

- CAF (1)

- Musepack

- W64

- CD tracks

- NIST

- WAV (2)

- FLAC

- OGG Vorbis

- WavPack

- IRCAM

- OPUS

- WMA and WMV (3)

 

(1) Support for PCM 8/16/24/32 bits, PCM 32 bits floating point, G711 U-LAW, G711 A-LAW

(2) Support for uncompressed PCM and compressed formats whose ACM codec is installed inside the system

(3) Require the availability of Windows Media Player modules on the target PC

 

Media files supported by Windows Media Foundation (only under Windows Vista and higher versions)
Media files supported by available DirectShow codecs

 

For audio files stored in RAW format use the MediaFileDecoder.FileOpenRaw method.

 

The opening and decoding of huge sized files can be canceled through the MediaFileDecoder.FileOpenCancel method.

An opened file can be closed through the MediaFileDecoder.FileClose method.

 

For details about management of media files decoding, refer to the How to decode media files tutorial.

 

 

Syntax

 

[Visual Basic]

Public Function FileOpen (

strPathname as String

) as Int32


 

[C#]

public Int32 FileOpen (

string strPathname

);


 

[C++]

public: Int32 FileOpen (

string strPathname

);


 

 

Parameter

Description

 

 

strPathname

String containing the absolute pathname of the media file to load.

 

 

Return value

 

Value

Meaning

 

 

enumErrorCodes.NOERROR (0)

The media file has been decoded successfully.

Negative value

An error occurred: see the LastError property for further error details or for a list of the possible error values.