Collapse All Expand All

IltmfConvert::put_TargetFile

#include "ltmf.h"

C Syntax	HRESULT IltmfConvert_put_TargetFile(pConvert, newVal)
C++ Syntax	HRESULT put_TargetFile(newVal)

 

IltmfConvert *pConvert;	/* pointer to an interface */
BSTR newVal;	/* file name */

Sets the media target to a file.

Parameter	Description
pConvert	Pointer to an IltmfConvert interface.
newVal	Character string that contains the media data file name.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation documentation.

Comments

This function allows the user to set the output of the conversion process to specified file name or stream. If the newVal parameter refers to a directory, it should contain the full path to the directory. A relative path can be used, but it is not recommended because relative paths are somewhat unpredictable.

The filename can be used to indicate a regular file or a stream.

The ResetSource function should be called to stop the convert object from accessing the file. The TargetType will be set to ltmfConvert_Target_File.

Required DLLs and Libraries

LTMF For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:	IltmfConvert::get_TargetFile, IltmfConvert::get_TargetType, IltmfConvert::ResetTarget
Topics:	Media Foundation Function Group
	ltmfConvert_Target Constants

Example

For a C++ example, refer to Recompressing an MP4 File for C++.