ILMDVRSink::GetBufferTotalSize

#include "ILMDVRSink.h"

C Syntax

HRESULT ILMDVRSink__GetBufferTotalSize(pILMDVRSink, nFolderIndex, uFlags, pnFiles, pnTotalFileSize)

C++ Syntax

HRESULT GetBufferTotalSize(nFolderIndex, uFlags, pnFiles, pnTotalFileSize)

 

ILMDVRSink *pILMDVRSink ;

/* pointer to an interface */

long nFolderIndex;

/* 0-based index of buffer location */

long uFlags;

/* flags */

long * pnFiles;

/* pointer to total number of files */

double * pnTotalFileSize;

/* pointer to total file size */

Gets the total size or actual size of all of the buffer (.LRC) files for the specified buffer folder.

Parameter

Description

pILMDVRSink

Pointer to an ILMDVRSink interface.

nFolderIndex

The 0-based index of the desired buffer folder.

uFlags

Flag specifying how to calculate the total size.
Values can be:

DVRGetTotalSize_Actual = 0x0000

DVRGetTotalSize_Allowed = 0x0001

pnFiles

Total number of files included in the buffer size calculation.

pnTotalFileSize

The total calculated buffer file size.

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

Pass the DVRGetTotalSize_Allowed flag value to request the total allowable buffer file size OR pass the DVRGetTotalSize_Actual flag value to request the actual used total file size.

 

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::SetBufferSize, ILMDVRSink::GetStatus, ILMDVRSink::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 ILMDVRSink__GetBufferTotalSize Example for C

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