LEADTOOLS Multimedia API Help > LEADTOOLS Multimedia Features > Multimedia Function References > IltmmConvert Interface > IltmmConvert::get_TargetFile |
The format to be used for the converted file. This includes the file format, any special settings used by that format, and which audio and/or video codec is to be used for the conversion, and any special settings used by the codecs.
A COmpressor combined with a DECompressor, or encoder and a decoder, which allows you to both compress and decompress that same data.
A set of files that contain all of the video and audio content for a DVD, organized with a table of contents (optional). See also: Title , Chapter , ISO Image .
The name for a group of related video files (called "Chapters") on your DVD. For example, for a DVD called "My Summer Vacation," you might have the titles "Water Skiing," "New Friends," and "Hiking." For each of those titles, you might have one or more different video files.
The name for each individual video file on a DVD. For example, under the title "Water Skiing", you might have the chapters "My first try," "My first wreck," and "My first jump."
An ISO image (.iso) is a disk image of a file system. It includes data files that are contained in the ISO image along with filesystem metadata. ISO images are an alternative to physical media for distribution of a "DVD" over the Internet. Most operating systems allow ISO images images to be "played" as if they were physical discs. See also: DVD Image.
#include "ltmm.h"
C Syntax |
HRESULT IltmmConvert_get_TargetFile(pConvert, pVal) |
C++ Syntax |
HRESULT get_TargetFile(pVal) |
IltmmConvert *pConvert; |
/* pointer to an interface */ |
BSTR *pVal; |
/* string */ |
Retrieves the target file name.
Parameter |
Description |
pConvert |
Pointer to an IltmmConvert interface. |
pVal |
Pointer to a character string that contains the target 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 DirectShow documentation. |
Comments
This function returns the string assigned with the put_TargetFile function. Please note that if the target format type, set using IltmmConvert::put_TargetFormat, is ltmmCapture_TargetFormat_DVD, then pVal will be updated with the full path to the directory in which the DVD image is located.
If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.
Required DLLs and Libraries
LTMM 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
Elements: |
IltmmConvert::get_TargetType, IltmmConvert::put_TargetFile, IltmmConvert::ResetTarget |
Topics: |
Example
For a C example, refer to Recompressing an AVI File for C.
For a C++ example, refer to Recompressing an AVI File for C++.