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

Структура WAVEHDR (mmeapi.h)

  • Статья

Структура WAVEHDR определяет заголовок, используемый для идентификации буфера waveform-audio.

Синтаксис

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

Члены

lpData

Указатель на буфер формы волны.

dwBufferLength

Длина буфера (в байтах).

dwBytesRecorded

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

dwUser

Пользовательские данные.

dwFlags

Побитовое ЗНАЧЕНИЕ ИЛИ , равное нулю или более флагам. Определены следующие флаги:

Имя Описание
WHDR_BEGINLOOP
 Этот буфер является первым буфером в цикле. Этот флаг используется только с буферами вывода.
WHDR_DONE
 Задается драйвером устройства, чтобы указать, что он завершен с буфером и возвращает его в приложение.
WHDR_ENDLOOP
 Этот буфер является последним буфером в цикле. Этот флаг используется только с буферами вывода.
WHDR_INQUEUE
 Устанавливается Windows, чтобы указать, что буфер поставлен в очередь для воспроизведения.
WHDR_PREPARED
 Устанавливается Windows, чтобы указать, что буфер был подготовлен с помощью функции waveInPrepareHeader или waveOutPrepareHeader .

dwLoops

Количество раз для воспроизведения цикла. Этот элемент используется только с буферами вывода.

lpNext

Зарезервировано.

reserved

Зарезервировано.

Комментарии

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

Элементы lpData, dwBufferLength и dwFlags должны быть заданы перед вызовом функции waveInPrepareHeader или waveOutPrepareHeader . (Для любой функции член dwFlags должен иметь нулевое значение.)

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть mmeapi.h (включая Windows.h)

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

Waveform Audio

Структуры волновой формы

waveInPrepareHeader

waveOutPrepareHeader