Open Omf or Ale file
Opens the Omf or Ale file designated by the full UNICODE path (cast to (char*)).
Internally, also allocates some required components, depending of file type.
The file must be a true Omf or Ale file. The function will check the file
extension, the presence of the Bento Container and Omf signature for Omf
files, and verify ascii for Ale files.
It will except Omf files with the file type extensions .omf, .aif, and .wav.
(Later Avid Omf-wrapped audio media files may have the .aif or .wav
extension - the SDK does not open raw aif or wav files)
Params:
mxOmfHdl_t hMxOmfHdl - address of SDK pointer from mxOmfCreateOmfSdk()
const TCHAR* pszPathName - FULL path of file to open - UNICODE
Returns:
MXOMFERR_NONE
MXOMFERR_NULLPOINTER - pszPathName param is NULL
MXOMFERR_CANNOTOPENFILE - Several possible failures -
File extension (type) must be .omf, .aif, .wav, or .ale
File must actually be an Omf or Ale file
File not found
Unrecoverable parsing error on Omf container or Ale
MXOMFERR_NOMEM - Some internal allocation failed
MXOMFERR_SDKHANDLNULL - hMxOmfHdl param is NULL
Usage:
See CMaxOmfSdkDemoOmfDoc::OnOpenDocument()
OMFDLL_EXPORT
MXOMFERROR mxOmfOpenOmf(mxOmfHdl_t hMxOmfHdl, const TCHAR* pszPathName = NULL);