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

Функция midiInPrepareHeader подготавливает буфер для входных данных MIDI.

Синтаксис

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

Параметры

hmi

Обработка для устройства ввода MIDI. Чтобы получить дескриптор устройства, вызовите midiInOpen.

pmh

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

Перед вызовом функции задайте элементы lpData, dwBufferLength и dwFlags структуры MIDIHDR . Элемент dwFlags должен иметь нулевое значение.

cbmh

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

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

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

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

Комментарии

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

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

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

Требования

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

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

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

Функции MIDI

midiInUnprepareHeader