ILMWMReader Interface

This is the interface for the LEAD Windows Media Reader filter.

Data Types

LMWMReader_APILEVEL

Summary

Lists the valid values for the ApiLevel parameter that can be passed to the ResetToDefaultsEx method.

Syntax

typedef enum 
{ 
   LMWMReader_APILEVEL_1 = 0, 
} LMWMReader_APILEVEL;

Enumeration	Description
LMWMReader_APILEVEL_1	Use the defaults from the current version of the filter.

Properties

Type	Name	Description
double	BufferingTime	The amount of data buffered before rendering (in seconds).

Methods

HRESULT GetBufferingProgress(long pPercent, double pTimeLeft)

Description

Call this while buffering to get information on the buffering process.

Parameters

pPercent

Pointer to a variable that will be updated with the amount of data buffered so far (as a percentage value between 0 and 100).

pTimeLeft

Pointer to a variable to be updated with the estimated number of seconds until the buffering is complete.

Comments

If you call this before buffering has started, the percentage reported might be 0.

If you call this after buffering has finished, the percentage reported might be 100.

You should call this method only after your application received the EC_BUFFERING_DATA (0x11) event notification.

Returns

Return	Description
S_OK	Succeeded.
< 0	An error occurred.

HRESULT StopBuffering()

Description

Stops buffering and start playback as soon as possible.

Comments

The behavior depends on the Windows Media components. The playback might still not start right away.

Returns

Return	Description
S_OK	Succeeded.
< 0	An error occurred.

HRESULT ResetToDefaultsEx (LMWMReader_APILEVEL ApiLevel)

Description

Resets the filter to default values.

Parameters

ApiLevel

Determines which default values to use. Current applications should set ApiLevel to LMWMReader_APILEVEL_1 = 0.

Comments

The Windows Media Reader might change in the future and have different properties or default behavior. Calling this method ensure the filter will have the same default values as they were at the time you developed your application.

It is recommended you call ResetToDefaultsEx(LMWMReader_APILEVEL_1) before you start setting properties and start calling other methods for this interface.