Функция acmStreamOpen (msacm.h)
Функция acmStreamOpen открывает поток преобразования ACM. Потоки преобразования используются для преобразования данных из одного указанного аудиоформата в другой.
Синтаксис
MMRESULT ACMAPI acmStreamOpen(
LPHACMSTREAM phas,
HACMDRIVER had,
LPWAVEFORMATEX pwfxSrc,
LPWAVEFORMATEX pwfxDst,
LPWAVEFILTER pwfltr,
DWORD_PTR dwCallback,
DWORD_PTR dwInstance,
DWORD fdwOpen
);
Параметры
phas
Указатель на дескриптор, который получит новый дескриптор потока, который можно использовать для выполнения преобразований. Этот дескриптор используется для идентификации потока в вызовах других функций преобразования потока ACM. Если указан флаг ACM_STREAMOPENF_QUERY, этот параметр должен иметь значение NULL.
had
Обработка для драйвера ACM. Если указан этот дескриптор, он определяет конкретный драйвер, который будет использоваться для потока преобразования. Если этот параметр имеет значение NULL, запрашиваются все подходящие установленные драйверы ACM, пока не будет найдено совпадение.
pwfxSrc
Указатель на структуру WAVEFORMATEX , которая определяет требуемый исходный формат для преобразования.
pwfxDst
Указатель на структуру WAVEFORMATEX , которая определяет нужный формат назначения для преобразования.
pwfltr
Указатель на структуру WAVEFILTER , определяющую требуемую операцию фильтрации для выполнения в потоке преобразования. Если операция фильтрации не является требуемой, этот параметр может иметь значение NULL. Если указан фильтр, исходный (pwfxSrc) и целевой форматы (pwfxDst) должны быть одинаковыми.
dwCallback
Указатель на функцию обратного вызова, дескриптор окна или дескриптор события. Функция обратного вызова будет вызываться только в том случае, если поток преобразования открыт с флагом ACM_STREAMOPENF_ASYNC. Функция обратного вызова получает уведомление при открытии или закрытии потока преобразования и после преобразования каждого буфера. Если поток преобразования открывается без флага ACM_STREAMOPENF_ASYNC, этот параметр должен иметь нулевое значение.
dwInstance
Данные пользовательского экземпляра передаются в функцию обратного вызова, заданную параметром dwCallback . Этот параметр не используется с обратными вызовами окон и событий. Если поток преобразования открывается без флага ACM_STREAMOPENF_ASYNC, этот параметр должен иметь нулевое значение.
fdwOpen
Флаги для открытия потока преобразования. Определены следующие значения.
[ACMSTREAMHEADER] Структура (./ns-msacm-acmstreamheader.md) для флага ACMSTREAMHEADER_STATUSF_DONE.| Значение | Значение |
|---|---|
| ACM_STREAMOPENF_ASYNC | |
| ACM_STREAMOPENF_NONREALTIME | ACM не будет учитывать ограничения по времени при преобразовании данных. По умолчанию драйвер пытается преобразовать данные в режиме реального времени. Для некоторых форматов указание этого флага может улучшить качество звука или другие характеристики. |
| ACM_STREAMOPENF_QUERY | ACM будет запрашиваться, чтобы определить, поддерживает ли он данное преобразование. Поток преобразования не будет открыт, и дескриптор не будет возвращен в параметре phas . |
| CALLBACK_EVENT | Параметр dwCallback является дескриптором события. |
| CALLBACK_FUNCTION | Параметр dwCallback является адресом процедуры обратного вызова. Прототип функции должен соответствовать прототипу acmStreamConvertCallback . |
| CALLBACK_WINDOW | Параметр dwCallback является дескриптором окна. |
Возвращаемое значение
Возвращает ноль в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Запрошенная операция не может быть выполнена. |
|
По крайней мере один флаг недопустим. |
|
Указанный дескриптор недопустим. |
|
По крайней мере один параметр недопустим. |
|
Системе не удается выделить ресурсы. |
Комментарии
Если драйвер ACM не может выполнять преобразования в режиме реального времени и флаг ACM_STREAMOPENF_NONREALTIME не указан для параметра fdwOpen , операция открытия не вернет код ошибки ACMERR_NOTPOSSIBLE. Приложение может использовать флаг ACM_STREAMOPENF_QUERY, чтобы определить, поддерживаются ли преобразования в режиме реального времени для входных данных.
Если приложение использует окно для получения сведений о обратном вызове, MM_ACM_OPEN, MM_ACM_CLOSE и MM_ACM_DONE сообщения отправляются в функцию процедуры окна, чтобы указать ход выполнения потока преобразования. В этом случае структура ACMSTREAMHEADER для MM_ACM_DONE, но она не используется для MM_ACM_OPEN и MM_ACM_CLOSE.
Если приложение использует функцию для получения сведений о обратном вызове, в функцию отправляются сообщения MM_ACM_OPEN, MM_ACM_CLOSE и MM_ACM_DONE для указания хода выполнения вывода waveform-audio. Функция обратного вызова должна находиться в библиотеке динамической компоновки (DLL).
Если приложение использует событие для уведомления обратного вызова, событие получает сигнал, указывающий на ход выполнения потока преобразования. Событие будет сигнализировать при открытии потока, после преобразования каждого буфера и при закрытии потока.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | msacm.h |
| Библиотека | Msacm32.lib |
| DLL | Msacm32.dll |