IltmmCapture::EstimateOutputSize

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture_EstimateOutputSize(pCapture, Duration, pSize)

C++ Syntax

HRESULT EstimateOutputSize(Duration, pSize)

 

IltmmCapture *pCapture;

/* pointer to an interface */

double Duration;

/* duration in seconds */

double *pSize;

/* pointer to a variable */

Retrieves the estimated capturing output size, in bytes, for the specified duration.

Parameter

Description

pCapture

Pointer to an IltmmCapture interface.

Duration

Value the represents the duration in seconds for which to retrieve the estimated output size.

pSize

Pointer to a variable to be updated with the estimated output size for the duration.

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

The estimated output size is calculated using the following equation:

Size = (Bitrate * Duration) / 8.

The returned size depends on the state of the capture object.

If the object is in the running state, the returned size is related to the actual number of bytes that have been written.

While if the object is not running, the returned size is a theoretical value dependent on the capturing settings and the chosen encoding settings.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

IltmmCapture::EstimateOutputBitRate

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmCapture::EstimateOutputSize Example for C.

For a C++ example, refer to IltmmCapture::EstimateOutputSize Example for C++.