функция acmFormatChooseW (msacm.h)

Статья
11/20/2024

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

Синтаксис

MMRESULT ACMAPI acmFormatChooseW(
  LPACMFORMATCHOOSEW pafmtc
);

Параметры

pafmtc

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

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

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

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

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

Замечания

Заметка

Заголовок msacm.h определяет ACMFORMATCHOOSE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	msacm.h
библиотеки	Msacm32.lib
DLL	Msacm32.dll

См. также

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

диспетчер сжатия звука

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