Поделиться через

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

  • Статья

Функция waveOutPrepareHeader подготавливает блок данных waveform-audio для воспроизведения.

Синтаксис

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

Параметры

hwo

Обработка устройства вывода waveform-audio.

pwh

Указатель на структуру WAVEHDR , которая идентифицирует блок данных для подготовки.

cbwh

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

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

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

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

Комментарии

Перед вызовом этой функции задайте члены lpData, dwBufferLength и dwFlags структуры WAVEHDR . Задайте для элемента dwFlags нулевое значение.

Члены dwFlags, dwBufferLength и dwLoops структуры WAVEHDR могут изменяться между вызовами этой функции и функции waveOutWrite. При изменении размера, заданного dwBufferLength перед вызовом waveOutWrite, новое значение должно быть меньше подготовленного значения.

Если метод выполнен успешно, флаг WHDR_PREPARED устанавливается в элементе dwFlags структуры WAVEHDR .

Подготовка уже подготовленного заголовка не оказывает никакого влияния, и функция возвращает ноль.

Требования

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

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

Waveform Audio

Функции waveform