OutputDebugString

VOID OutputDebugString( LPCTSTR lpOutputString );

Аргументы

0. lpOutputString — указатель на заканчивающуюся нулём строку, которую необходимо вывести.

Примечание

Функция OutputDebugString посылает строку отладчику текущего приложения. Если приложение не имеет отладчика, эта строка отображается системным отладчиком. Если приложение не имеет отладчика и системный отладчик не активирован, функция OutputDebugString не производит никаких действий.

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

PlaySound

BOOL PlaySound( LPCSTR pszSound, HMODULE hmod, DWORD fdwSound );

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

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

Аргументы

0. pszSound — строка, определяющая воспроизводимый фрагмент аудио информации. Если данный аргумент имеет нулевое значение, то прекращается воспроизведение любого фрагмента аудио информации, имеющего формат waveform. Для остановки воспроизведения аудио информации, имеющей другой формат, в аргументе fdwSound должен быть установлен флаг SND_PURGE.

1. Интерпретация значения данного аргумента зависит от установленного в аргументе fdwSound флага (SND_ALIAS, SND_FILENAME или SND_RESOURCE). Этот аргумент может содержать имя системного события, имя файла или идентификатор ресурса. Если не установлен ни один из этих флагов, функция PlaySound просматривает системный реестр или файл win.ini для нахождения соответствия указанному имени. В случае успешного поиска воспроизводится соответствующий системный звук. В противном случае значение данного аргумента интерпретируется как имя файла.

2. hmod — дескриптор исполняемого файла, содержащего загружаемый ресурс. Этот аргумент должен иметь нулевое значение, если в аргументе fdwSound не установлен флаг SND_RESOURCE.

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

• SND_APPLICATION — вывод аудио информации производится с использованием определённых в приложении ассоциаций.

• SND_ALIAS — в аргументе pszSound содержится имя системного события, определённое в системном реестре или в файле win.ini. Этот флаг несовместим с флагами SND_FILENAME и SND_RESOURCE.

• SND_ALIAS_ID — в аргументе pszSound содержится предопределённый идентификатор аудио информации.

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

• SND_FILENAME — в аргументе pszSound содержится имя файла.

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

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

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

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

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

• SND_PURGE — прекращается вывод всей аудио информации для вызвавшей задачи. Если аргумент pszSound имеет ненулевое значение, прекращается воспроизведение всех экземпляров указанной аудио информации. Если аргумент pszSound имеет нулевое значение, прекращается воспроизведение всей аудио информации, воспроизводимой данным приложением. Для прекращения воспроизведения события SND_RESOURCE необходимо указать дескриптор файла.

• SND_RESOURCE — в аргументе pszSound содержится идентификатор ресурса; аргумент hmod должен содержать дескриптор исполняемого файла, определяющий ресурс.

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

Примечание

Функция PlaySound воспроизводит аудио информацию, определяемую именем файла, ресурсом или системным событием. (сиñтемные события могут связываться с аудио информацией в системном реестре или в файле win.ini.)

Аудио информация, определяемая в аргументе pszSound должна полностью помещаться в оперативную память и выводиться установленным в системе драйвером аудио устройства. При поиске файлов функция PlaySound просматривает следующие директории: текущий директорий, директорий Windows, системный директорий Windows, директории, перечисленные в команде PATH и списке сетевых директориев. Порядок просмотра директориев совпадает с порядком, установленным для функции OpenFile.

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

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