функция acmFilterEnumW (msacm.h)

Статья
11/20/2024

Функция acmFilterEnum перечисляет фильтры волнового звука, доступные для заданного тега фильтра из драйвера ACM. Эта функция продолжает перечислять, пока не будет больше подходящих фильтров для тега фильтра или функции обратного вызова возвращается FALSE.

Синтаксис

MMRESULT ACMAPI acmFilterEnumW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW pafd,
  ACMFILTERENUMCBW    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

Параметры

had

Обработайте драйвер ACM для запроса сведений о фильтре волнового звука. Если этот параметр null, ACM использует сведения из первого подходящего драйвера ACM.

pafd

Указатель на структуру ACMFILTERDETAILS, содержащую сведения о фильтре при передаче функции, указанной fnCallback. Когда приложение вызывает acmFilterEnum, cbStruct, pwfltrи cbwfltr члены этой структуры должны быть инициализированы. Элемент dwFilterTag также должен быть инициализирован для WAVE_FILTER_UNKNOWN или допустимого тега фильтра.

fnCallback

Адрес экземпляра процедуры для функции обратного вызова, определяемой приложением.

dwInstance

32-разрядная (DWORD), 64-разрядная (DWORD_PTR) определяемая приложением значение, передаваемое в функцию обратного вызова, а также сведения о фильтре ACM.

fdwEnum

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

[ACMFILTERDETAILS]Допустима структура (./nf-msacm-acmfilterdetails.md). Перечислитель перечисляет только фильтр, соответствующий этому атрибуту. Член dwFilterTagструктуре ACMFILTERDETAILS должен быть равен члену dwFilterTagструктуре WAVEFILT ER.

Ценность	Значение
ACM_FILTERENUMF_DWFILTERTAG

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

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

Возвращаемый код	Описание
ACMERR_NOTPOSSIBLE	Сведения о фильтре не могут быть возвращены.
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.

Замечания

Функция acmFilterEnum вернет MMSYSERR_NOERROR (ноль), если не установлены подходящие драйверы ACM. Кроме того, функция обратного вызова не будет вызываться.

Следующие функции не должны вызываться из функции обратного вызова: acmDriverAdd, acmDriverRemoveи acmDriverPriority.

Заметка

Заголовок msacm.h определяет acmFilterEnum как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	msacm.h
библиотеки	Msacm32.lib
DLL	Msacm32.dll

См. также

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

диспетчер сжатия звука

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