WaveOutGetPlaybackRate

MMRESULT waveOutGetPlaybackRate( HWAVEOUT hwo, LPDWORD pdwRate );

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

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

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

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

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

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

Аргументы

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

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

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

Примечание

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

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

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

WaveOutGetPosition

MMRESULT waveOutGetPosition( HWAVEOUT hwo, LPMMTIME pmmt, UINT cbmmt );

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

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

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

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

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

Аргументы

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

1. pmmt — указатель на объект структуры MMTIME идентифицирующий подготавливаемый буфер.

2. cbmmt — размер структуры MMTIME в байтах.

Примечание

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

Перед вызовом данной функции следует инициализировать переменную wType объекта структуры MMTIME, задав в ней желаемый формат вывода информации о времени. После вызова данной функции значение переменной wType указывает на то, в каком формате в действительности была предоставлена информация. Этот формат может не совпадать с заданным, поскольку в том случае, когда заданный формат не поддерживается, информация предоставляется в альтернативном формате.

Текущая позиция воспроизведения устанавливается в ноль при открытии или сбросе устройства.

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