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

  • Статья

Функция 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

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

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

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