Функция acmFormatChoose (msacm.h)

Статья
08/24/2023

Функция acmFormatChoose создает диалоговое окно, определяемое ACM, которое позволяет пользователю выбрать формат waveform-audio.

Синтаксис

MMRESULT ACMAPI acmFormatChoose(
  LPACMFORMATCHOOSE pafmtc
);

Параметры

pafmtc

Указатель на структуру ACMFORMATCHOOSE , содержащую сведения, используемые для инициализации диалогового окна. Когда эта функция возвращается, эта структура содержит сведения о выборе формата пользователем.

Элемент pwfx этой структуры должен содержать допустимый указатель на расположение памяти, который будет содержать возвращаемую структуру заголовка формата. Кроме того, член cbwfx должен быть заполнен размером (в байтах) этого буфера памяти.

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

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

Код возврата	Описание
ACMERR_CANCELED	Чтобы закрыть диалоговое окно, пользователь нажимает кнопку Отмена или команду Закрыть в меню Система.
ACMERR_NOTPOSSIBLE	Буфер, определяемый элементом pwfx структуры ACMFORMATCHOOSE , слишком мал, чтобы содержать выбранный формат.
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.
MMSYSERR_NODRIVER	Подходящий драйвер недоступен для предоставления допустимых вариантов выбора формата.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	msacm.h
Библиотека	Msacm32.lib
DLL	Msacm32.dll

См. также раздел

Функции сжатия звука

Диспетчер сжатия аудио

Поделиться через