In This Topic ▼

ILMDVRSink::GetBufferInfo

Summary

Gets the DVRSink buffer information associated with the specified buffer file index.

Syntax

#include "ILMDVRSink.h"

Language	Syntax
C	HRESULT ILMDVRSink_GetBufferInfo(pILMDVRSink, nBufferIndex, pszFileName, pnUsefulSize, pnFileSize, pnPlayIndex, pnFlags)
C++	HRESULT GetBufferInfo(nBufferIndex, pszFileName, pnUsefulSize, pnFileSize, pnPlayIndex, pnFlags)

Parameters

ILMDVRSink *pILMDVRSink

Pointer to an ILMDVRSink interface.

long nBufferIndex

The 0-based index of the buffer file for which to get information.

BSTR * pszFileName

A pointer to a string type that will receive the filename of the related buffer recording file.

double * pnUsefulSize

A pointer to a double type that will receive the used file size of the current recording chunk file.

double * pnFileSize

A pointer to a double type that will receive the physical file size of the current recording chunk file.

long * pnPlayIndex

A pointer to a long type that will receive the index in playing order (the first index might not be 0, but all files should have sequential and incrementing indexes after the first index value).

long * pnFlags

A pointer to a long type that will receive a DVRBufferFlagConstant setting. Possible values are:

DVRBuffer_Empty = 0x0001
DVRBuffer_Writing = 0x0002
DVRBuffer_Finished = 0x0004

Returns

Value	Meaning
S_OK	The function was successful.
E_INVALIDARG	Buffer index supplied is outside the range of currently valid indexes.
LTMM_E_DVR_NO_RECORDINGS	No .LRC recording files exist.
E_OUTOFMEMORY	A memory allocation error occurred when attempting to allocate storage for the buffer filename string.
<>S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.