MediaFileDecoder.FileOpen method |
|
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] control.MediaFileDecoder.FileOpen ( strPathname as String ) as enumErrorCodes |
[C++] short control.MediaFileDecoder.FileOpen ( LPCTSTR 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. |