IltmmMediaInfo::get_SourceBitRate

#include "ltmm.h"

C Syntax

HRESULT IltmmMediaInfo_get_SourceBitRate(pMediaInfo, BitRate)

C++ Syntax

HRESULT get_SourceBitRate(BitRate)

 

IltmmMediaInfo *pMediaInfo;

/* pointer to an interface */

long *BitRate;

/* pointer to a variable */

Retrieves the calculated bit rate of the current source media file, in bits per second.

Parameter

Description

pMediaInfo

Pointer to an IltmmMediaInfo Interface.

BitRate

Pointer to a variable to be updated with the calculated bit rate of the current source media file, in bits per second.

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 bit rate obtained by this function is calculated as follows:

BitRate = (FileSize * 8) / SourceDuration

Where FileSize and SourceDuration are retrieved using IltmmMediaInfo::get_SourceFileSize and IltmmMediaInfo::get_SourceDuration, respectively.

To get the current source media file, call IltmmMediaInfo::get_SourceFile.

The current source media file, set using IltmmMediaInfo::put_SourceFile, is the file for which the IltmmMediaInfo interface/object gets information. This function must be called before calling any of the other IltmmMediaInfo functions used for retrieving information.

Call IltmmMediaInfo::ResetSource to release the source file when it is no longer needed.

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.

Platforms

Win32, x64

See Also

Elements:

IltmmMediaInfo interface, IltmmMediaInfo::get_SourceFile, IltmmMediaInfo::put_SourceFile, IltmmMediaInfo::get_SourceFilter, IltmmMediaInfo::get_SourceFilterClassID, IltmmMediaInfo::get_SourceFilterDispatch, IltmmMediaInfo::get_SourceMediaType, IltmmMediaInfo::get_SourceFormat, IltmmMediaInfo::get_SourceFormatName, IltmmMediaInfo::get_SourceDuration, IltmmMediaInfo::get_SourceFileSize

Topics:

Multimedia Function Group
Media File Information

Example

For a C example, refer to Retrieving Media File Information for C.

For a C++ example, refer to Retrieving Media File Information for C++.