IWMPConvert::ConvertFile method

The ConvertFile method is implemented by a conversion plug-in and called by Windows Media Player to enable a conversion plug-in to convert a digital media file into ASF.

Syntax

HRESULT ConvertFile(
  BSTR bstrInputFile,
  BSTR bstrDestinationFolder,
  BSTR *pbstrOutputFile
);

Parameters

bstrInputFile

BSTR containing the path to the file to be converted.

bstrDestinationFolder

BSTR containing that path to the folder where the converted file must be copied.

pbstrOutputFile

Pointer to a BSTR that receives the path to the converted file.

Return value

The method returns an HRESULT. The following table lists recommended return codes.

Return code/value Description
NS_E_WMP_CONVERT_FILE_FAILED
0xC00D1158
Unspecified failure while converting the file.
NS_E_WMP_CONVERT_NO_RIGHTS_ERRORURL
0xC00D1159
The license prohibits file conversion. IWMPConvert::GetErrorURL must return the URL of the webpage that describes the issue.
NS_E_WMP_CONVERT_NO_RIGHTS_NOERRORURL
0xC00D115A
The license prohibits file conversion. There is no error URL available.
NS_E_WMP_CONVERT_FILE_CORRUPT
0xC00D115B
The specified file is corrupted.
NS_E_WMP_CONVERT_PLUGIN_UNAVAILABLE_ERRORURL
0xC00D115C
There is an unspecified problem with the plug-in. IWMPConvert::GetErrorURL must return the URL of the webpage where the user can reinstall the plug-in.
NS_E_WMP_CONVERT_PLUGIN_UNAVAILABLE_NOERRORURL
0xC00D115D
There is an unspecified problem with the plug-in. There is no error URL available.
NS_E_WMP_CONVERT_PLUGIN_UNKNOWN_FILE_OWNER
0xC00D115E
This conversion plug-in is not the correct one to convert the current file.

Remarks

This is a synchronous call. Your code must complete and return as quickly as possible. This method is not intended to be used for transcoding digital media files. You should use this method only to change the file format.

Windows Media Player 10 Mobile: This method is not supported.

Requirements

   
Minimum supported client Windows Media Player, build 10.00.00.4521 or later
Target Platform Windows
Header wmpservices.h

See also

IWMPConvert Interface