#include "ltmm.h"

C Syntax

HRESULT IltmmConvert_put_TargetFile(pConvert, newVal)

C++ Syntax

HRESULT put_TargetFile(newVal)

IltmmConvert *pConvert;

pointer to an interface

BSTR newVal;

file name

Sets the media target to a file.




Pointer to an IltmmConvert interface.


Character string that contains the media data file name.



The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.


This function allows the user to set the output of the conversion process to specified file name or stream. If the target format set using IltmmConvert::put_TargetFormat is ltmmConvert_TargetFormat_DVD, then the newVal parameter contains the directory in which the DVD image is located. Otherwise, newVal contains the name of a media file. 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. If the target format type is ltmmConvert_TargetFormat_DVD and newVal contains the name of an existing file, that file will be deleted, and a directory/folder will be created with the same name.

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 ltmmConvert_Target_File.

For more details on the filename syntax, refer to:

TargetFile syntax
Required DLLs and Libraries


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


Win32, x64

See Also


IltmmConvert::get_TargetFile, IltmmConvert::get_TargetType, IltmmConvert::ResetTarget


Multimedia Function Group


ltmmConvert_Target Constants


How to Use the DVD Writer to Write a DVD Image


TargetFile syntax


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

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

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help