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

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

Синтаксис

MMRESULT waveOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSA pwoc,
  UINT           cbwoc
);

Параметры

uDeviceID

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

pwoc

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

cbwoc

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

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

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

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

Замечания

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 2000 Профессиональный
минимальный поддерживаемый сервер	Сервер Windows 2000
Header	mmeapi.h
Library	Winmm.lib
DLL	Winmm.dll

См. также

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

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