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

  • Статья

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

Синтаксис

MMRESULT ACMAPI acmFormatTagDetails(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Параметры

had

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

paftd

Указатель на структуру ACMFORMATTAGDETAILS для получения сведений о теге формата.

fdwDetails

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

[ACMFORMATTAGDETAILS] () структура. Сведения о теге формата будут возвращены в структуре, на которую указывает paftd. Если приложение указывает дескриптор драйвера ACM для had, для этого драйвера будут возвращены сведения о теге формата. Если приложение указывает значение NULL для had, ACM находит первый допустимый драйвер, возвращающий сведения. [ACMDRIVERDETAILS] Структура (./nf-msacm-acmdriverdetails.md) для драйвера ACM. Приложение должно указать дескриптор драйвера для had при получении сведений о теге формата с этим флагом. [ACMFORMATTAGDETAILS] () Структура должна быть WAVE_FORMAT_UNKNOWN или тегом формата для поиска наибольшего размера. Если приложение указывает дескриптор драйвера ACM для had, для этого драйвера будут возвращены сведения о самом большом теге формата. Если приложение указывает значение NULL для had, ACM находит приемлемый драйвер с наибольшим тегом формата, запрошенным для возврата сведений.
Значение Значение
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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

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

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

Требования

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

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

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

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