SndPlaySound

BOOL sndPlaySound( LPCSTR lpszSound, UINT fuSound );

Возвращаемое значение

В случае успешного завершения работы возвращает значение TRUE, в противном случае возвращает значение FALSE.

Аргументы

0. pszSound — строка, определяющая воспроизводимый фрагмент аудио информации. Этот аргумент может содержать имя системного события, связанное с данным фрагментом аудио информации в системном реестре или в файле win.ini, или имя аудио файла. (Если функция не может сопоставить значению данного аргумента системное событие, она трактует его как имя файла.) Если данный аргумент имеет нулевое значение, то прекращается воспроизведение любого фрагмента аудио информации.

1. fdwSound — флаги, определяющие воспроизводимый фрагмент аудио информации. Определены следующие значения:

• SND_ASYNC — аудио информация выводится в асинхронном режиме, а функция PlaySound возвращает управление сразу же после начала воспроизведения аудио информации. Для завершения воспроизведения аудио информации в асинхронном режиме достаточно вызвать функцию sndPlaySound, задав ей нулевое значение аргумента lpszSoundName.

• SND_LOOP — аудио информация выводится в циклическом режиме пока не будет вызвана функция sndPlaySound с нулевым значением аргумента lpszSoundName. Кроме того, следует также установить флаг SND_ASYNC для задания асинхронного режима работы.

• SND_MEMORY — файл аудио информации, соответствующий событию, помещается в оперативной памяти. Аргумент lpszSoundName должен содержать указатель на образ аудио информации в памяти.

• SND_NODEFAULT — не используется системный звук, заданный по умолчанию. Если звук не может быть найден, функция sndPlaySound ничего не воспроизводит.

• SND_NOSTOP — если в данный момент воспроизводится какой-нибудь фрагмент аудио информации, функция sndPlaySound возвращает значение FALSE и не воспроизводит требуемый фрагмент аудио информации.

• SND_SYNC — аудио информация выводится в синхронном режиме. Функция sndPlaySound возвращает управление сразу же после окончания воспроизведения аудио информации.

Примечание

Функция sndPlaySound воспроизводит аудио информацию, определяемую именем файла или записью в системном реестре или в файле win.ini. Возможности данной функции являются подмножеством возможностей функции PlaySound. Функция sndPlaySound сохранена для обеспечения совместимости со старыми приложениями.

Если функции sndPlaySound не удалось обнаружить указанный фрагмент аудио информации, она выводит вместо него системный звук, заданный по умолчанию. Если в системном реестре или в файле win.ini по умолчанию не задан никакой системный звук, или этот звук не может быть найден, то функция PlaySound ничего не выводит и возвращает значение FALSE.

Аудио информация, определяемая в аргументе pszSound должна полностью помещаться в оперативную память и выводиться установленным в системе драйвером аудио устройства. Если указанный файл не найден в текущем директории, его поиск производится в порядке, установленном для функции OpenFile.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.