IltmmCapture::EstimateOutputBitRate

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture_EstimateOutputBitRate(pCapture, pBitRate)

C++ Syntax

HRESULT EstimateOutputBitRate(pBitRate)

 

IltmmCapture *pCapture;

/* pointer to an interface */

long *pBitRate;

/* pointer to a variable */

Retrieves the estimated capturing output bit rate, in bits per second.

Parameter

Description

pCapture

Pointer to an IltmmCapture interface.

pBitRate

Pointer to a variable to be updated with the estimated output bit rate.

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 returned bit rate depends on the state of the capture object.

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

While if the object is not running, the returned bit rate 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::EstimateOutputSize

Topics:

Multimedia Function Group

Example

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

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