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

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

  • Статья

Функция midiOutUnprepareHeader очищает подготовку, выполняемую функцией midiOutPrepareHeader .

Синтаксис

MMRESULT midiOutUnprepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Параметры

hmo

Дескриптор для устройства вывода MIDI. Этот параметр также может быть дескриптором потока MIDI, приведения к HMIDIOUT.

pmh

Указатель на структуру MIDIHDR , определяющую очищаемый буфер.

cbmh

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

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

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

Код возврата Описание
MIDIERR_STILLPLAYING
 Буфер, на который указывает lpMidiOutHdr , по-прежнему находится в очереди.
MMSYSERR_INVALHANDLE
 Указанный дескриптор устройства недопустим.
MMSYSERR_INVALPARAM
 Указан недопустимый указатель или структура.

Комментарии

Эта функция дополняет функцию midiOutPrepareHeader . Перед освобождением буфера необходимо вызвать midiOutUnprepareHeader . После передачи буфера в драйвер устройства с функцией midiOutLongMsg необходимо подождать, пока драйвер устройства завершит работу с буфером, прежде чем вызывать midiOutUnprepareHeader.

Отмена подготовки буфера, который не был подготовлен, не оказывает влияния, и функция возвращает MMSYSERR_NOERROR.

Требования

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

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

Выделение и подготовка блоков данных MIDI

Функции MIDI