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

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

Синтаксис

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA pwic,
  UINT          cbwic
);

Параметры

uDeviceID

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

pwic

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

cbwic

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

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

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

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

Замечания

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

Требования

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