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

Статья
08/24/2023

Функция acmFormatDetails запрашивает у ACM сведения о формате для определенного тега формата waveform-audio.

Синтаксис

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Параметры

had

Выполните запрос к драйверу ACM для запроса сведений о формате waveform-audio для тега формата. Если этот параметр имеет значение NULL, ACM использует сведения из первого подходящего драйвера ACM.

pafd

Указатель на структуру ACMFORMATDETAILS , содержащую сведения о формате для заданного тега формата.

fdwDetails

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

[ACMFORMATDETAILS] () была предоставлена структура и должны быть возвращены оставшиеся сведения. Член dwFormatTag структуры ACMFORMATDETAILS должен быть инициализирован с тем же тегом формата, что и pwfx . Этот тип запроса можно использовать для получения строкового описания структуры произвольного формата. Если приложение указывает дескриптор драйвера ACM для had, для этого драйвера будут возвращены сведения о формате. Если приложение указывает значение NULL для had, ACM находит первый допустимый драйвер, возвращающий сведения.

Значение	Значение
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Индекс формата для тега format был указан в элементе dwFormatIndex структуры ACMFORMATDETAILS . Сведения о формате будут возвращены в структуре, определенной pafd. Индекс в диапазоне от нуля до единицы меньше, чем элемент cStandardFormats , возвращенный в структуре ACMFORMATTAGDETAILS для тега формата. Приложение должно указать дескриптор драйвера для had при получении сведений о формате с этим флагом. Сведения о том, какие элементы следует инициализировать перед вызовом этой функции, см. в статье Структура ACMFORMATDETAILS .

Значение

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Индекс формата для тега format был указан в элементе dwFormatIndex структуры ACMFORMATDETAILS . Сведения о формате будут возвращены в структуре, определенной pafd. Индекс в диапазоне от нуля до единицы меньше, чем элемент cStandardFormats , возвращенный в структуре ACMFORMATTAGDETAILS для тега формата. Приложение должно указать дескриптор драйвера для had при получении сведений о формате с этим флагом. Сведения о том, какие элементы следует инициализировать перед вызовом этой функции, см. в статье Структура ACMFORMATDETAILS .

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

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

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

Требования

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

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

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

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