Products | Support | Send comments on this topic. | Email a link to this topic. | Back to Getting Started | Help Version 18.0.11.27
LEADTOOLS Media Foundation Help

IltmfCapture::put_TargetFile

Show in webframe

#include "ltmf.h"

C Syntax

HRESULT IltmfCapture_put_TargetFile(pCapture, newVal)

C++ Syntax

HRESULT put_TargetFile(newVal)

 

IltmfCapture *pCapture;

/* pointer to an interface */

BSTR newVal;

/* file name */

Sets the media target to a file.

Parameter

Description

pCapture

Pointer to an IltmfCapture 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 MediaFoundation documentation.

Comments

This function allows the user to set the output of the capturing process to the specified file name. 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.

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 ltmfCapture_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:

IltmfCapture::get_TargetFile, IltmfCapture::get_TargetType, IltmfCapture::ResetTarget, ltmfCapture_Target Constants

Topics:

Media Foundation Function Groups

 

Use ltmf Capture to Perform a Capture and Save It as a WMV File

Example

For a C++ example, refer to Advanced Capture Examople for C++.

Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.