ILMDVRSink::StartBackupToFile

#include "ILMDVRSink.h"

C Syntax

HRESULT ILMDVRSink_StartBackupToFile(pILMDVRSink, pszTargetFile, flags)

C++ Syntax

HRESULT StartBackupToFile(pszTargetFile, flags)

 

ILMDVRSink *pILMDVRSink ;

/* pointer to an interface */

BSTR pszTargetFile

/*fully qualified path name to the backup file */

long flags

/*reserved for future use - set to 0*/

Call this method to start writing DVR recording data to a separate backup file.

Parameter

Description

pILMDVRSink

Pointer to an ILMDVRSink interface.

pszTargetFile

Pointer to a fully qualified path name to the destination backup file.

flags

Reserved for future use.  Set value to 0.

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

Starts writing the DVR recording data to the specified backup file. This function is not affected by DVR settings or by calls to the ILMDVRSINK::StartChangingAttributes or ILMDVRSINK::StopChangingAttributes methods. A call to ILMDVRSINK::StopBackupToFile stops writing DVR data.

Required DLLs and Libraries

ILMDVRSink

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:

ILMDVRSink::StopBackupToFile, ILMDVRSink::CopyBufferToFile

Topics:

Multimedia Function Group, DVR Function Groups, Introduction to the LEADTOOLS DVR Module, DVR Module FAQs, LEAD DVR Sink Filter, Accessing the DVR Sink Object,How to Use the DVR Sink Object to Control Capture Buffer Settings (C++), How to Set Capture Buffers on More Than One Physical Disk, How to Copy Buffered DVR Data to a New File

Example

For C example, refer to ILMDVRSink::StartBackupToFile Example for C

For C++ example, refer to ILMDVRSink::StartBackupToFile Example for C++