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

Статья
11/20/2024

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

Синтаксис

MMRESULT auxGetDevCapsW(
  UINT_PTR   uDeviceID,
  LPAUXCAPSW pac,
  UINT       cbac
);

Параметры

uDeviceID

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

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

pac

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

cbac

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	mmeapi.h (включая Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

звуковой waveform

Функции волнообразной формы

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