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.

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