IWMPConvert::ConvertFile method (wmpservices.h)

  • 项目

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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(
  [in]  BSTR bstrInputFile,
  [in]  BSTR bstrDestinationFolder,
  [out] BSTR *pbstrOutputFile
);

Parameters

[in] bstrInputFile

BSTR containing the path to the file to be converted.

[in] bstrDestinationFolder

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

[out] 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