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

Статья
11/20/2024

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

Синтаксис

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  DWORD               fdwDetails
);

Параметры

had

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

pafd

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

fdwDetails

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

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

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

Ценность

Значение

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

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

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

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

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

Замечания

Заметка

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

Требования

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

См. также

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

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

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