ILMDVRSource::ReadData

#include "ILMDVRSource.h"

C Syntax

HRESULT ILMDVRSource__ReadData(pILMDVRSource, startOffset, minSize, maxSize, dwUserData, pData, pSizeRead)

C++ Syntax

HRESULT ReadData(startOffset, minSize, maxSize, dwUserData, pData, pSizeRead)

 

ILMDVRSource *pILMDVRSource;

/* pointer to an interface */

double startOffset;

/* data read starting offset */

long minSize;

/* minimum size to read*/

long maxSize;

/* maximum size to read */

DWORD dwUserData;

/* Reserved */

BYTE * pData;

/* pointer to a block of memory data */

long * pSizeRead;

/* pointer to data read size */

Reads the DVRSource data associated with the specified offset.

Parameter

Description

pILMDVRSource

Pointer to an ILMDVRSource interface.

startOffset

A double value indicating the starting offset for the read operation.

minSize

A long value specifying the minimum size to read.

maxSize

A long value specifying the maximum size to read.

dwUserData

Reserved.

pData

A pointer to a block of memory that will receive the read data.

pSizeRead

Pointer to a long type that will receive the size of the read data.

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

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

E_UNEXPECTED = Unexpected invalid file handle

LTMM_E_DVR_DISCARDED_DATA = Data has been discarded due to a restart.

LTMM_E_DVR_CORRUPT_STUB_FILE = Corrupted .LBL file.

Required DLLs and Libraries

ILMDVRSource

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:

ILMDVRSource::GetAvailabilityInfo, ILMDVRSource::CopyBufferToFile, ILMDVRSource::ResetToDefaultsEx, ILMDVRSource::GetBufferInfo

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 ILMDVRSource__ReadData Example For C

For a C++ example, refer to ILMDVRSource::ReadData Example For C++