MCI_SOUND

This MCI command message plays system sounds identified in the [sounds] section of the WIN.INI file. The name of the sound is specified in the buffer pointed to by the lpstrSoundName field of the data structure identified by lpInfo. This is an MCI system message that is not sent to any device.

Parameters

DWORD dwFlags

The following standard and command-specific flags apply to all devices:

MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window to receive this message is specified in the dwCallback field of the data structure identified by lpInfo.

MCI_WAIT

Specifies that the playing of the sound should finish before MCI returns control to the application.

MCI_SOUND_NAME

Indicates that the name of a sound to play is included in the lpstrSoundName of the data structure identified by lpSound. If omitted, the default sound is played.

LPMCI_SOUND_PARMS lpInfo

Specifies a far pointer to the MCI_SOUND_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

This command will only play files that fit into available memory. Use the MCI waveform audio device to play longer waveform files.