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

  • Статья

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

Синтаксис

MMRESULT ACMAPI acmFilterTagDetails(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Параметры

had

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

paftd

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

fdwDetails

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

[ACMFILTERTAGDETAILS] () структура. Сведения о теге фильтра будут возвращены в структуре, на которую указывает paftd. Если приложение указывает дескриптор драйвера ACM для had, для этого драйвера будут возвращены сведения о теге фильтра. Если приложение указывает значение NULL для had, ACM находит первый допустимый драйвер, возвращающий сведения. [ACMDRIVERDETAILS] Структура (./nf-msacm-acmdriverdetails.md) для драйвера ACM. Приложение должно указать дескриптор драйвера для had при получении сведений о теге фильтра с этим флагом.
Значение Значение
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE Необходимо вернуть сведения о теге фильтра с наибольшим размером фильтра (в байтах). Член dwFilterTag должен быть WAVE_FILTER_UNKNOWN или тегом фильтра, чтобы найти самый большой размер. Если приложение указывает дескриптор драйвера ACM для had, для этого драйвера будут возвращены сведения о самом большом теге фильтра. Если приложение указывает значение NULL для had, ACM находит приемлемый драйвер с наибольшим тегом фильтра, запрошенным для возврата сведений.

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

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

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

Требования

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

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

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

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