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

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

Синтаксис

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

Параметры

uDeviceID

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

pwic

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

cbwic

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

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

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

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

Замечания

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

Требования

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

См. также

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