MCI Functions

MCI Functions

MCI Functions

MCI_device(): Retrieves the device identifier corresponding to the name of an open device.

Syntax

MCI_device( szDevice ) è nDevice

Parameters

szDevice device name or the alias name by which the device is known.

Returns

nDevice device identifier assigned to the device when it was opened if successful. The identifier is used in the mciSendCommand() function. If the device name is not known, if the device is not open, or if there was not enough memory to complete the operation, the return value is zero.

MCI_error(): Gets last MCI command error string.

Alias

MCI_LastError(), MCI_GetlastError()

Comment

When calling this function the last MCI error is cleared off.

Syntax

MCI_error() è szMCIError

Parameters

None.

Returns

szMCIError error string.

MCI_IsRiff(): Is a given file in the RIFF format?

Syntax

MCI_IsRiff( szFile ) è lRiff

Parameters

szFile file to test.

Returns

lRiff .T. if RIFF format; .F. otherwise.

MCI_IsWave(): Is a given file in the WAVE format?

Syntax

MCI_IsWave( szFile ) è lWave

Parameters

szFile file to test.

Returns

lWave .T. if WAVE format; .F. otherwise.

MCI_LastVersion(): Returns the file stamp of MCI functions.

Remark

This function helps the developer identifying the last version of a set of functions. Sometimes the global version information of FOCUS.FLL (MIS_major() and MIS_minor()) does not help tracking down the changes in a project. Starting with version 6.0 of FOCUS.FLL, each source file has now an internal date and time stamp.

Syntax

MCI_LastVersion() è szLastVersion

Parameters

None.

Returns

szLastVersion string identifying the last version of the functions set. The string is similar to "C:\Focus\5.0\MCI.C-Mon Oct 19 15:55:22 1998".

MCI_send(): Sends a command to MCI devices.

Special

You should take a look at multimedia commands in order to use this function.

Syntax

MCI_send( szCommand ) è szDescription

Parameters

szCommand command to be executed by MCI devices.

Returns

szDescription textual description of MCI command execution.