Функция waveOutWrite (mmeapi.h)

Функция waveOutWrite отправляет блок данных на заданное устройство вывода волны-аудио.

Синтаксис

MMRESULT waveOutWrite(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Параметры

hwo

Дескриптор устройства вывода waveform-audio.

pwh

Указатель на структуру WAVEHDR , содержащую сведения о блоке данных.

cbwh

Размер структуры WAVEHDR в байтах.

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

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

Код возврата	Описание
MMSYSERR_INVALHANDLE	Указан недопустимый дескриптор устройства.
MMSYSERR_NODRIVER	Отсутствует драйвер устройства.
MMSYSERR_NOMEM	Не удается выделить или заблокировать память.
WAVERR_UNPREPARED	Блок данных, на который указывает параметр pwh , не подготовлен.

Комментарии

После завершения буфера WHDR_DONE бит задается в элементе dwFlags структуры WAVEHDR .

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

Требования

Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mmeapi.h (включая Windows.h)
Библиотека	Winmm.lib
DLL	Winmm.dll

См. также раздел

Звуковой сигнал

Функции волнообразной формы