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


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

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

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

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

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