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

Статья
08/24/2023

Функция 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 для 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	По крайней мере один параметр недопустим.

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

Требования

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

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

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

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

Share via