IltmmCapture::put_TargetFile

#include "ltmm.h"

C Syntax	HRESULT IltmmCapture_put_TargetFile(pCapture, newVal)
C++ Syntax	HRESULT put_TargetFile(newVal)

IltmmCapture *pCapture;	/* pointer to an interface */
BSTR newVal;	/* file name */

Sets the media target to a file.

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.
newVal	Character string that contains the receive 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 DirectShow documentation.

Comments

This function allows the user to set the output of the capturing process to the specified file name. If the target format 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 A COmpressor combined with a DECompressor, or encoder and a decoder, which allows you to both compress and decompress that same data. is to be used for the conversion, and any special settings used by the codecs. set using IltmmCapture::put_TargetFormat is ltmmCapture_TargetFormat_DVD, then the newVal parameter contains the directory in which the DVD image 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 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., Chapter 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.", ISO Image 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.. 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 ltmmCapture_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 ResetTarget function should be called to stop the capture object from accessing the file or stream. The TargetType will be set to ltmmCapture_Target_File.

For more details on the filename syntax, refer to:

TargetFile syntax

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.

Platforms

Win32, x64

Elements:	IltmmCapture::get_TargetFile, IltmmCapture::get_TargetType, IltmmCapture::ResetTarget, ltmmCapture_Target Constants
Topics:	Multimedia Function Groups
	Use ltmm Capture to Perform a Capture and Save It as a WMV File
	TargetFile syntax