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

Статья
08/24/2023

Функция acmFormatSuggest запрашивает ACM или указанный драйвер ACM, чтобы предложить формат назначения для предоставленного исходного формата. Например, приложение может использовать эту функцию для определения одного или нескольких допустимых форматов PCM, в которых можно распаковывать сжатый формат.

Синтаксис

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Параметры

had

Обработка к открытому экземпляру драйвера для запроса предлагаемого формата назначения. Если этот параметр имеет значение NULL, ACM пытается найти лучший драйвер, чтобы предложить формат назначения.

pwfxSrc

Указатель на структуру WAVEFORMATEX , определяющую исходный формат, для которого формат назначения будет предложен ACM или указанным драйвером.

pwfxDst

Указатель на структуру WAVEFORMATEX , которая получит предлагаемый формат назначения для формата pwfxSrc . В зависимости от параметра fdwSuggest некоторые элементы структуры, на которые указывает pwfxDst , могут потребовать инициализации.

cbwfxDst

Размер в байтах, доступный для формата назначения. Функции acmMetrics и acmFormatTagDetails можно использовать для определения максимального размера, необходимого для любого формата, доступного для указанного драйвера (или для всех установленных драйверов ACM).

fdwSuggest

Флаги для соответствия требуемому формату назначения. Определены следующие значения.

Значение	Значение
ACM_FORMATSUGGESTF_NCHANNELS	Допустимый член nChannels структуры, на которую указывает pwfxDst . ACM будет запрашивать допустимые установленные драйверы, которые могут предложить формат назначения, соответствующий nChannels или сбой .
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	Допустимый член nSamplesPerSec структуры, на которую указывает pwfxDst . ACM будет запрашивать допустимые установленные драйверы, которые могут предложить формат назначения, соответствующий nSamplesPerSec или сбой.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	Допустимый член wBitsPerSample структуры, на которую указывает pwfxDst . ACM будет запрашивать допустимые установленные драйверы, которые могут предложить формат назначения, соответствующий wBitsPerSample или сбой.
ACM_FORMATSUGGESTF_WFORMATTAG	Член wFormatTag структуры, на которую указывает pwfxDst , является допустимым. ACM будет запрашивать допустимые установленные драйверы, которые могут предложить формат назначения, соответствующий wFormatTag , или сбой.

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

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

Код возврата	Описание
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.

Требования


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

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

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

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