Windows Media Player 11 SDK IWMPConvert::ConvertFile 

  • Article

Windows Media Player SDK banner art

Previous Next

IWMPConvert::ConvertFile

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

[in] BSTR containing the path to the file to be converted.

bstrDestinationFolder

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

pbstrOutputFile

[out] Pointer to a BSTR that receives the path to the converted file.

Return Values

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 Web page 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 Web page 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

Version: Windows Media Player, build 10.00.00.4521 or later

Header: Defined in wmpservices.h

See Also

Previous Next