WaveOutBreakLoop

MMRESULT waveOutBreakLoop( HWAVEOUT hwo );

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

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае может возвращать следующие значения:

• MMSYSERR_INVALHANDLE — указан недопустимый дескриптор устройства.

• MMSYSERR_NODRIVER — отсутствует драйвер устройства.

• MMSYSERR_NOMEM — невозможно выделить или заблокировать память.

Аргументы

0. hwo — дескриптор устройства вывода аудио информации.

Примечание

Функция waveOutBreakLoop прекращает циклическое воспроизведение на указанном устройстве вывода аудио информации и позволяет драйверу перейти к воспроизведению следующего блока в списке драйвера.

Прежде чем циклическое воспроизведение будет прекращено, будут воспроизведены все блоки от текущего до последнего блока в цикле.

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

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

WaveOutClose

MMRESULT waveOutClose( HWAVEOUT hwo );

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

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае может возвращать следующие значения:

• MMSYSERR_INVALHANDLE — указан недопустимый дескриптор устройства.

• MMSYSERR_NODRIVER — отсутствует драйвер устройства.

• MMSYSERR_NOMEM — невозможно выделить или заблокировать память.

• WAVERR_STILLPLAYING — буфер, на который указывает аргумент pwh, всё ещё находится в очереди на воспроизведение.

Аргументы

0. hwo — дескриптор устройства вывода аудио информации. Если функция успешно завершает свою работу, то данный дескриптор не может больше использоваться.

Примечание

Функция waveOutClose закрывает указанное устройство вывода аудио информации.

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

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

WaveOutGetDevCaps

MMRESULT waveOutGetDevCaps( UINT uDeviceID, LPWAVEOUTCAPS pwoc, UINT cbwoc );

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

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае может возвращать следующие значения:

• MMSYSERR_BADDEVICEID — указанный идентификатор устройства имеет значение, выходящее за допустимый диапазон.

• MMSYSERR_NODRIVER — отсутствует драйвер устройства.

• MMSYSERR_NOMEM — невозможно выделить или заблокировать память.

Аргументы

0. uDeviceID — идентификатор устройства вывода аудио информации. В данном аргументе может передаваться допустимое значение идентификатора устройства или дескриптор открытого устройства вывода аудио информации.

1. pwoc — указатель на объект структуры WAVEOUTCAPS, в которую будет записана информация о возможностях устройства.

2. cbwoc — размер объекта структуры WAVEOUTCAPS в байтах.

Примечание

Функция waveOutGetDevCaps позволяет получить информацию о возможностях указанного устройства вывода аудио информации.

Идентификатор устройства, передаваемый в аргументе uDeviceID, может принимать любые значения от нуля до величины, на единицу меньшей числа устройств, установленных в системе. Кроме того, в нём может использоваться константа WAVE_MAPPER. Для определения числа установленных в системе устройств вывода аудио информации используется функция waveOutGetNumDevs. В область памяти, на которую указывает аргумент pwoc, может быть записано не более cbwoc байт информации. Если аргумент cbwoc имеет нулевое значение, то функция ничего не копирует и возвращает нулевое значение.

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