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

Статья
08/24/2023

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

Синтаксис

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

Параметры

had

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

pafd

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

fdwDetails

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

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

Значение	Значение
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Индекс фильтра для тега фильтра был задан в элементе dwFilterIndex структуры ACMFILTERDETAILS . Сведения о фильтре будут возвращены в структуре, определенной pafd. Индекс в диапазоне от нуля до одного меньше, чем элемент cStandardFilters , возвращенный в структуре ACMFILTERTAGDETAILS для тега фильтра. Приложение должно указать дескриптор драйвера для had при получении сведений о фильтре с этим флагом. Сведения о том, какие элементы следует инициализировать перед вызовом этой функции, см. в статье Структура ACMFILTERDETAILS .

Значение

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

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

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

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

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

Требования


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

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

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

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

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