ILMWMReader Interface

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

Data types:

LMWMReader_APILEVEL:

typedef enum
{
   LMWMReader_APILEVEL_1 = 0,
} LMWMReader_APILEVEL;

Constant

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).

 

Interface Methods

 

HRESULT  GetBufferingProgress(long *pPercent, double *pTimeLeft)

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.

Description

Call this while buffering to get information on the buffering process. 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 function only after your application received the EC_BUFFERING_DATA (0x11) event notification.

Returns

S_OK if succeeded, < 0 error code otherwise.

 

HRESULT   StopBuffering()

Parameters

None.

Description

Stop buffering and start playback as soon as possible. Note that the behaviour depends on the Windows Media components. The playback might still not start right away.

Returns

S_OK if succeeded, < 0 error code otherwise.

 

HRESULT  ResetToDefaultsEx (LMWMReader_APILEVEL ApiLevel)

Parameters

ApiLevel

Determines which default values to use.

Description

Resets the filter to default values. The ApiLevel determines which default values to use. Current applications should set ApiLevel to LMWMReader_APILEVEL_1 = 0.

The Windows Media Reader might change in the future and have different properties or default behaviour. 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.

Returns

S_OK if succeeded, < 0 error code otherwise.