Share via

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

  • Статья

Функция midiOutGetDevCaps запрашивает указанное устройство вывода MIDI для определения его возможностей.

Синтаксис

MMRESULT midiOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSW pmoc,
  UINT           cbmoc
);

Параметры

uDeviceID

Идентификатор устройства вывода MIDI. Идентификатор устройства, указанный этим параметром, варьируется от нуля до одного меньше числа присутствующих устройств. Константой MIDI_MAPPER также является допустимый идентификатор устройства.

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

pmoc

Указатель на структуру MIDIOUTCAPS . Эта структура заполняется сведениями о возможностях устройства.

cbmoc

Размер структуры MIDIOUTCAPS в байтах . Только байты cbMidiOutCaps (или меньше) информации копируются в расположение, на которое указывает lpMidiOutCaps. Если cbMidiOutCaps равно нулю, ничего не копируется и функция возвращает MMSYSERR_NOERROR.

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

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

Код возврата Описание
MMSYSERR_BADDEVICEID
 Указанный идентификатор устройства выходит за пределы диапазона.
MMSYSERR_INVALPARAM
 Указан недопустимый указатель или структура.
MMSYSERR_NODRIVER
 Драйвер не установлен.
MMSYSERR_NOMEM
 Системе не удается загрузить описание строки модуля сопоставления.

Комментарии

Чтобы определить количество устройств вывода MIDI, присутствующих в системе, используйте функцию midiOutGetNumDevs .

Примечание

Заголовок mmeapi.h определяет midiOutGetDevCaps в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

Функции MIDI