ILMDVRSink::CopyBufferToFile

#include "ILMDVRSink.h"

C Syntax

HRESULT ILMDVRSink__CopyBufferToFile(pILMDVRSink, pszTargetFile, startOffset, endOffset)

C++ Syntax

HRESULT CopyBufferToFile(pszTargetFile, startOffset, endOffset)

 

ILMDVRSink *pILMDVRSink ;

/* pointer to an interface */

BSTR pszTargetFile;

/* pointer to the target file */

double startOffset;

/* starting offset */

double endOffset;

/* ending offset */

Copies the buffered recording data to the specified fully qualified target file pathname.

Parameter

Description

pILMDVRSink

Pointer to an ILMDVRSink interface.

pszTargetFile

Pointer to a fully qualified destination file.

startOffset

Starting offset of data to copy.

endOffset

Ending offset of data to copy.

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

Use this function to copy buffered recording data to a new output file. The output file will contain the same media sample data and encodings as the original buffer data.

S_OK if successful, otherwise a return code indicating the reason for failure:

E_UNEXPECTED = Starting offset not found.

DISP_E_BADINDEX = Index supplied is outside the range of currently valid indexes.

LTMM_E_DVR_NO_RECORDINGS = No .LRC recording files exist.

E_INVALIDARG = Either the number of files or file size specified is not valid.

Required DLLs and Libraries

LMDVRSink

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::GetAvailabilityInfo, , ILMDVRSink::GetStatus, ILMDVRSink::CreateEvents, ILMDVRSink::FreeEvents, ILMDVRSink::StartChangingAttributes, ILMDVRSink::StopChangingAttributes, ILMDVRSink::put_BaseName, ILMDVRSink::get_BaseName

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 a C example, refer to ILMDVRSink__CopyBufferToFile Example for C

For a C++ example, refer to ILMDVRSink::CopyBufferToFile Example for C++