WaveOutReset

MMRESULT waveOutReset( HWAVEOUT hwo );

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

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

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

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

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

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

Аргументы

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

Примечание

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

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

WaveOutRestart

MMRESULT waveOutRestart( HWAVEOUT hwo );

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

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

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

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

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

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

Аргументы

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

Примечание

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

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

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

WaveOutSetPitch

MMRESULT waveOutSetPitch( HWAVEOUT hwo, DWORD dwPitch );

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

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

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

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

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

• MMSYSERR_NOTSUPPORTED — указанное устройство не позволяет регулировать тональность.

Аргументы

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

1. dwPitch — новое значение коэффициента тона. Коэффициент тона определяет текущее изменение оригинальной тональности. Этот коэффициент должен иметь положительное значение.

2. Коэффициент тона хранится в формате числа с фиксированной точкой. Старшее слово этой переменной представляет собой целую часть числа со знаком, и младшее слово — его дробную часть. Величина 0x8000 в младшем слове означает одну вторую, а значение 0x4000 — одну четвёртую. Например, значение 0x00010000 соответствует единичному значению коэффициента (никаких изменений тональности), а значение 0x000F8000 определяет коэффициент тона равный 15.5.

Примечание

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

Изменение тональности не изменяет темпа воспроизведения, частоты дискретизации или времени воспроизведения. Не все устройства допускают изменение тональности. Для определения того, позволяет ли данное устройство изменять тональность, следует вызвать функцию waveOutGetDevCaps и проверить состояние флага WAVECAPS_PITCH в переменной dwSupport возвращаемого ей объекта структуры WAVEOUTCAPS.

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