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++