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

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

  • Статья

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

Синтаксис

MMRESULT auxGetDevCapsA(
  UINT_PTR   uDeviceID,
  LPAUXCAPSA pac,
  UINT       cbac
);

Параметры

uDeviceID

Идентификатор вспомогательного устройства вывода для запроса. Укажите допустимый идентификатор устройства (см. следующий раздел примечаний) или используйте следующую константу:

Значение Значение
AUX_MAPPER Вспомогательный звуковой сопоставителя. Функция возвращает ошибку, если вспомогательный модуль сопоставления аудио не установлен.

pac

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

cbac

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

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

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

Код возврата Описание
MMSYSERR_BADDEVICEID
 Указанный идентификатор устройства выходит за пределы диапазона.

Комментарии

Идентификатор устройства в uDeviceID варьируется от нуля до единицы меньше, чем количество присутствующих устройств. также можно использовать AUX_MAPPER. Используйте функцию auxGetNumDevs , чтобы определить количество вспомогательных устройств вывода, присутствующих в системе.

Примечание

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

Требования

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

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

Waveform Audio

Функции waveform