WaveInGetDevCaps

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

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

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

• MMSYSERR_BADDEVICEID — указанный идентификатор устройства имеет значение, выходящее за допустимый диапазон.

• MMSYSERR_NODRIVER — отсутствует драйвер устройства.

• MMSYSERR_NOMEM — невозможно выделить или заблокировать память.

Аргументы

0. uDeviceID — идентификатор устройства ввода аудио информации. В данном аргументе может передаваться допустимое значение идентификатора устройства или дескриптор открытого устройства ввода аудио информации.

1. pwic — указатель на объект структуры WAVEINCAPS, в которую будет записана информация о возможностях устройства.

2. cbwic — размер объекта структуры WAVEINCAPS в байтах.

Примечание

Функция waveInGetDevCaps позволяет получить информацию о возможностях указанного устройства ввода аудио информации.

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

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

WaveInGetErrorText

MMRESULT waveInGetErrorText( MMRESULT mmrError, LPSTR pszText, UINT cchText );

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

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

• MMSYSERR_BADERRNUM — указанное значение ошибки находится за пределами допустимого диапазона.

• MMSYSERR_NODRIVER — отсутствует драйвер устройства.

• MMSYSERR_NOMEM — невозможно выделить или заблокировать память.

Аргументы

0. mmrError — номер ошибки.

1. pszText — указатель на буфер, в который будет помещено текстуальное описание ошибки.

2. cchText — размер буфера, на который указывает аргумент pszText, в байтах.

Примечание

Функция waveInGetErrorText позволяет получить текстуальное описание ошибки, идентифицируемой своим значением.

Если текстуальное описание ошибки превышает размеры выделенного буфера, то оно урезается. Возвращаемое текстовое описание всегда заканчивается нулём. Если аргумент cchText имеет нулевое значение, то в буфер ничего не записывается и данная функция возвращает нулевое значение. Все описания ошибок имеют длину меньшую, чем MAXERRORLENGTH.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

WaveInGetNumDevs

UINT waveInGetNumDevs(VOID);

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

Возвращает количество устройств. Нулевое возвращаемое значение указывает на отсутствие устройств в системе или на возникновение ошибки.

Примечание

Функция waveInGetNumDevs позволяет получить число устройств ввода аудио информации, установленных в системе.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.