Дипломная работа: Разработка программного обеспечения для голосового управления трехмерными моделями функционирования промышленных роботов
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
LPWAVEHDR pwh,
U1NT cbwh);
Параметры:
hwi - указатель
на записывающее устройство;
pwh - указатель на структуру WAVEHDR,
идентифицирующую буфер, который необходимо очистить.
cbwh - размер, в байтах,
структуры WAVEHDR.
Функция возвращает MMSYSERR_NOERROR, если всё проходит успешно, если есть ошибки, возвращается
одно из значений, приведенных в табл. 3.4.
Эта функция дополняет waveInPrepareHeader
функцию. Необходимо вызвать эту функцию перед
освобождением буфера. После передачи буфера в драйвер устройства функцией waveInAddBuffer, необходимо ждать, пока
драйвер не закончит работу с буфером перед запросом waveInUnprepareHeader. Очистка
буфера, который не был занят, не имеет никакого эффекта, и функция возвращает
ноль.
Таблица 3.4 – Значения, выдаваемые при ошибках
Ошибка |
Значение |
MMSYSERR_INVALHANDLE |
указанный дескриптор устройства недействителен |
MMSYSERR_NODRIVER |
нет драйвера для устройства |
MMSYSERR_NOMEM |
невозможно использовать память |
MMSYSERR_STILLPLAYING |
буфер, указанный pwh, занят |
Для передачи буфера приёма данных предоставленному звуковому
устройству используется функция waveInAddBuffer.
Когда буфер заполнен, приложение получает
соответствующее сообщение. Функция имеет следующий вид:
MMRESULT waveInAddBuffer(HWAVEIN hwi,
LPWAVEHDR pwh,
UINT cbwh);
Описание параметров:
hwi- указатель
на входное устройство;
pwh - указатель на структуру WAVEHDR,
которая идентифицирует буфер.
cbwh - размер,
в байтах, структуры WAVEHDR.
Функция возвращает MMSYSERR_NOERROR, если всё проходит успешно, если есть ошибки, возвращает одно
из значений, приведенных в табл. 3.5.
Таблица 3.5 - Возвращаемые значения
Ошибка |
Значение |
MMSYSERR_INVALHANDLE |
указанный дескриптор устройства недействителен |
MMSYSERR_NODRIVER |
нет драйвера для устройства |
MMSYSERR_NOMEM |
невозможно использовать память |
WAVERR_UNPREPARED |
буфер, указанный pwh, не был готов |
Когда буфер заполнен, бит WHDR_DONE установлен в dwFlags -члене
структуры WAVEHDR.
Буфер должен быть подготовлен функцией waveInPrepareHeader перед тем, как это будет
передаваться функции waveInAddBuffer.
Далее вызывается функция waveInStart.
Она начинает ввод данных через предоставленное
устройство. Эта функция выглядит следующим образом:
MMRESULT waveInStart(HWAVEIN hwi);
Параметр hwi указывает
на устройство, принимающее информацию.
Функция возвращает MMSYSERR_NOERROR, если всё проходит успешно,
если есть ошибки, возвращается одно значений, приведенных в табл. 3.6
Таблица 3.6 - Возвращаемые значения
Ошибка |
Значение |
MMSYSERR_INVALHANDLE |
указанный дескриптор устройства недействителен |
MMSYSERR_NODRIVER |
нет драйвера для устройства |
MMSYSERR_NOMEM |
невозможно использовать память |
Буферы возвращаются приложению, когда заполнены или, когда вызвана
функция waveInReset(dwBytesRecorded) член
в заголовке будет содержать длину данных). Если нет никаких буферов в очереди,
данные проходят мимо приложения, и ввод продолжается.
Вызов этой функции, когда она уже была вызвана, не имеет эффекта,
и функция возвращает ноль [15].
3.1.3 Основные функции, необходимые для воспроизведения звука.
Для воспроизведения звуковой информации первая функция waveOutOpen. Она открывает устройство
вывода для звукового потока. В модуле она объявлена следующим образом:
MMRESULT waveOutOpen (LPHWAVEIN phwi,
UINT_PTR uDeviceID, LPWAVEFORMATEX pwfx,
DWORD_PTR dwCallback, DWORD_PTR dwCallbacklnstance, DWORD fdwOpen);
В функции определен ряд параметров. Рассмотрим их основное
назначение
phwi - адрес, по которому будет
записан указатель на устройство воспроизведения;
UDeviceID -
идентификатор устройства, которое необходимо открыть, если поставить сюда
константу WAVE_MAPPER, то откроется устройство по умолчанию.
lpFormat - указатель
на структуру типа WAVEFORMATEX, в которой описан формат воспроизводимых
звуковых данных.
dwCallback -
указатель на функцию «семафор». Эта функция вызывается для сообщения о текущих
событиях.
dwFlags - параметры открываемого
устройства. Может принимать следующие значения, совпадающие со значениями fdwOpen для функции wavelnOpen
Структура WAVEFORMATEX для воспроизведения звуковой информации
имеет такой же вид, как и для записи. Однако при воспроизведении звука, она
заполняется автоматически при выборе воспроизводимого файла.
Страницы: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21 |