Ready Function

event tables {{AFX_EVENT(CMp3PCtrl)

This event is fired after the control has finished loading

Protected void FireReady()

Ack Function

An acknowledgement event which is fired to acknowledge a method invocation

Protected void FireAck()

Nack Function

A negative acknowledgement - the last command could not be processed
An error code is returned

Protected void FireNack(short )

State Function

Fires on a state change. Possible values:
Stopped - 0
Playing - 1
Paused - 2
EOF (end of input stream) - 3

Protected void FireState(short )

Mode Function

Fires when GetPlayerMode is called
The value of the player's mode is an OR'ed combination of mode flags.
See the documentation of the "Mode" method for more details

Protected void FireMode(long )

InputState Function

Fires on an input state change (e.g. when a file is opened).
The new value of the player's input state is passed with the message.
Valid values for the state are:
Open - 0
Closed - 1

Protected void FireInputState(short )

InputPos Function

Fires when the input position has changed.

Protected void FireInputPos(long , long )

InputTimecode Function

Fires when the input timecode has changed.

Protected void FireInputTimecode(short , short , short , short )

OutputState Function

Fires on an output state change (e.g. a file begins to play)
The new value of the player's output state is passed with the message.
Valid values for the state are:
Open - 0
Closed - 1

Protected void FireOutputState(short )

Volume Function

Fires to inform of the current volume

Protected void FireVolume(short , short , short )

Balance Function

Fires when an output is set and when GetMasterVolume is called

Protected void FireBalance(short )

Debug Function

Debug messages are used by the decoder and the different input and output modules and filters to send back debug information that can be displayed by the application

Protected void FireDebug(short , LPCTSTR )

XError Function

Protected void FireXError(short , LPCTSTR )

InputDuration Function

Contains the duration of the current input stream

Protected void FireInputDuration(long )

Pong Function

This event is fired in response to the "Ping" method being called

Protected void FirePong(long )

Exited Function

Fires when the control is exited

Protected void FireExited()

PlayerEnvironmentInteger Function

Contains the value of a integer environment variable

Protected void FirePlayerEnvironmentInteger(LPCTSTR , long )

PlayerEnvironmentString Function

Contains the value of an string environment variable

Protected void FirePlayerEnvironmentString(LPCTSTR , LPCTSTR )

InputName Function

Fires when the input name is set or GetInputName is called

Protected void FireInputName(LPCTSTR )

InputCaps Function

Contains the players current input capabilities

Protected void FireInputCaps(long )

InputPostionRange Function

Fires when GetPositionRange and GetPositionPercentage is called

Protected void FireInputPositionRange(long )

InputTimecodeGranularity Function

Containts the current input timecode granularity value

Protected void FireInputTimecodeGranularity(long )

InputStreamInfo Function

Contains information about the current input stream:
MPEG level (1 for MPEG 1, 2 for MPEG 2, 0 for MPEG 2.5)
MPEG layer (1, 2 or 3)
bitrate in bits per second
sampling frequency in Hz
MPEG mode (0 for stereo, 1 for joint-stereo, 2 for dual-channel, 3 for mono)

Protected void FireInputStreamInfo(short , short , short , short , short )

InputModule Function

Fires on GetInputModuleName call, contains the current input module ID

Protected void FireInputModule(short )

InputModuleInfo Function

Contains information about an input module:
ID of the module
number of devices handled by this module
name of the module
description of the module

Protected void FireInputModuleInfo(short , short , LPCTSTR , LPCTSTR )

InputDeviceInfo Function

Contains information about an input device of an input module:
ID of the module this device belongs to
index of this device within a module (first is 0).
device flags
device name
device description

Protected void FireInputDeviceInfo(short , short , short , LPCTSTR , LPCTSTR )

InputFilterInfo Function

Contains information about an input filter
filter name
id of the filter

Protected void FireInputFilterInfo(LPCTSTR , short )

OutputName Function

Fires when the output name is set or GetOutputName is called

Protected void FireOutputName(LPCTSTR )

OutputCaps Function

Contains the current output capabilities

Protected void FireOutputCaps(long )

PCMLevel Function

Fires when an output is set and when GetMasterVolume is called

Protected void FirePCMLevel(short )

MasterLevel Function

Fires when an output is set and when GetMasterVolume is called

Protected void FireMasterLevel(short )

OutputChannels Function

Contains the current output channels configuration

Protected void FireOutputChannels(short )

OutputPorts Function

Contains the current output ports configuration

Protected void FireOutputPorts(long )

OutputModule Function

Contains the current output module ID

Protected void FireOutputModule(short )

OutputModuleInfo Function

Contains information about an output module:
ID of the module
number of devices handled by this module
name of the module
description of the module

Protected void FireOutputModuleInfo(short , short , LPCTSTR , LPCTSTR )

OutputDeviceInfo

Contains information about an output device of an output module:
ID of the module this device belongs to
index of this device within a module (first is 0)
device flags
device name
device description

Protected void FireOutputDeviceInfo(short , short , short , LPCTSTR , LPCTSTR )

OutputFilterInfo Function

Contains information about an output filter:
filter name
ID of the filter

Protected void FireOutputFilterInfo(LPCTSTR , short )

NotificationMask Function

Contains the current notification mask

Protected void FireNotificationMask(long )

DebugLevel Function

Fires when GetDebugLevel is called

Protected void FireDebugLevel(short )

Progress Function

A progress message (typically used by input modules like the network streaming module to notify the client of progress info like buffer fullness, network connection status, etc...)
Information includes:
ID of the module that sent the message
progress code (user-defined)
a progress value
a user-defined string that gives textual information about the progress message

Protected void FireProgress(short , short , short , LPCTSTR )