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

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

  • Статья

Функция waveOutGetDevCaps извлекает возможности данного устройства вывода waveform-audio.

Синтаксис

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

Параметры

uDeviceID

Идентификатор устройства вывода waveform-audio. Это может быть идентификатор устройства или дескриптор открытого устройства вывода waveform-audio.

pwoc

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

cbwoc

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

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

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

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

Комментарии

Используйте функцию waveOutGetNumDevs , чтобы определить количество устройств вывода waveform-audio, присутствующих в системе. Если значение, указанное параметром uDeviceID , является идентификатором устройства, оно может отличаться от нуля до единицы меньше, чем количество присутствующих устройств. Константу WAVE_MAPPER также можно использовать в качестве идентификатора устройства. Только байты cbwoc (или меньше) информации копируются в расположение, на который указывает pwoc. Если значение cbwoc равно нулю, ничего не копируется и функция возвращает ноль.

Требования

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

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

Waveform Audio

Функции waveform