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

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

Синтаксис

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

Параметры

uDeviceID

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

pwoc

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

cbwoc

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

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

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

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

Замечания

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

Требования

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

См. также

Звук в форме волны

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