WaveInPrepareHeader

MMRESULT waveInPrepareHeader( HWAVEIN hwi, LPWAVEHDR pwh, UINT cbwh );

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

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

• MMSYSERR_INVALHANDLE — указан недопустимый дескриптор устройства.

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

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

Аргументы

0. hwi — дескриптор устройства ввода аудио информации.

1. pwh — указатель на объект структуры WAVEHDR идентифицирующий подготавливаемый буфер.

2. cbwh — размер структуры WAVEHDR в байтах.

Примечание

Функция waveInPrepareHeader подготавливает буфер для ввода аудио информации.

Переменные lpData, dwBufferLength и dwFlags объекта структуры WAVEHDR должны быть инициализированы до вызова данной функции. (Переменная dwFlags должна иметь нулевое значение.)

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

WaveInProc

void CALLBACK waveInProc( HWAVEIN hwi, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2 );

Аргументы

0. hwi — дескриптор аудио устройства, связанного с данной функцией обратного вызова.

1. uMsg — сообщение, посылаемое данной функции. Это может быть одно из следующих сообщений:

• WIM_CLOSE — посылается при закрытии аудио устройства функцией waveInClose.

• WIM_DONE — посылается драйвером устройства после заполнения им блока данных, переданного ему функцией waveInAddBuffer.

• WIM_OPEN — посылается при открытии аудио устройства функцией waveInOpen.

0. dwInstance — пользовательские данные, определённые в функции waveInOpen.

1. dwParam1 — аргумент сообщения.

2. dwParam2 — аргумент сообщения.

Примечание

Функция waveInProc представляет собой функцию обратного вызова, используемую при вводе аудио информации. Имя функции waveInProc является условным и может быть заменено другим именем, не используемым другими функциями. Адрес этой функции должен содержатся в соответствующем аргументе функции waveInOpen.

Из функции обратного вызова не могут вызываться никакие системные функции, кроме следующих: EnterCriticalSection, LeaveCriticalSection, midiOutLongMsg, midiOutShortMsg, OutputDebugString, PostMessage, PostThreadMessage, SetEvent, timeGetSystemTime, timeGetTime, timeKillEvent и timeSetEvent. Вызов любой другой функции работы с аудио информацией может вызвать зависание системы.

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

WaveInReset

MMRESULT waveInReset( HWAVEIN hwi );

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

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

• MMSYSERR_INVALHANDLE — указан недопустимый дескриптор устройства.

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

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

Аргументы

0. hwi — дескриптор устройства ввода аудио информации.

Примечание

Функция waveInReset останавливает запись на указанном устройстве ввода аудио информации и устанавливает текущую позицию записи в ноль. Все буфера, ожидающие записи на данном устройстве, помечаются как обработанные и возвращаются приложению.

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