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

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

  • Статья

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

Синтаксис

MMRESULT midiInUnprepareHeader(
  HMIDIIN   hmi,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Параметры

hmi

Обработка для устройства ввода MIDI.

pmh

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

cbmh

Размер структуры MIDIHDR .

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

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

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

Комментарии

Эта функция дополняет midiInPrepareHeader. Эту функцию необходимо использовать перед освобождением буфера. После передачи буфера драйверу устройства с помощью функции midiInAddBuffer необходимо дождаться завершения работы драйвера с буфером, прежде чем использовать midiInUnprepareHeader. Отмена подготовки буфера, который не был подготовлен, не оказывает влияния, и функция возвращает MMSYSERR_NOERROR.

Требования

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

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

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

Функции MIDI