WaveOutGetErrorText

MMRESULT waveOutGetErrorText( MMRESULT mmrError, LPSTR pszText, UINT cchText );

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

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

• MMSYSERR_BADERRNUM — указанное значение ошибки находится за пределами допустимого диапазона.

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

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

Аргументы

0. mmrError — номер ошибки.

1. pszText — указатель на буфер, в который будет помещено текстуальное описание ошибки.

2. cchText — размер буфера, на который указывает аргумент pszText, в байтах.

Примечание

Функция waveOutGetErrorText позволяет получить текстуальное описание ошибки, идентифицируемой своим значением.

Если текстуальное описание ошибки превышает размеры выделенного буфера, то оно урезается. Возвращаемое текстовое описание всегда заканчивается нулём. Если аргумент cchText имеет нулевое значение, то в буфер ничего не записывается и данная функция возвращает нулевое значение. Все описания ошибок имеют длину меньшую, чем MAXERRORLENGTH.

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

WaveOutGetNumDevs

UINT waveOutGetNumDevs(VOID);

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

Возвращает количество устройств. Нулевое возвращаемое значение указывает на отсутствие устройств в системе или на возникновение ошибки.

Примечание

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

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

WaveOutGetPitch

MMRESULT waveOutGetPitch( HWAVEOUT hwo, LPDWORD pdwPitch );

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

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

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

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

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

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

Аргументы

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

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

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

Примечание

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

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

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