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

Статья
08/24/2023

Функция acmMetrics возвращает различные метрики для ACM или связанных объектов ACM.

Синтаксис

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

Параметры

hao

Обработка объекта ACM для запроса метрики, указанной в uMetric. Для некоторых запросов этот параметр может иметь значение NULL.

uMetric

Индекс метрики, возвращаемый в pMetric.

Значение	Значение
ACM_METRIC_COUNT_CODECS	Возвращаемое значение — это количество глобальных драйверов ACM для сжатия или распаковки в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_CONVERTERS	Возвращаемое значение — это количество глобальных драйверов преобразователя ACM в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_DISABLED	Возвращаемое значение — общее количество глобальных отключенных драйверов ACM (всех типов поддержки) в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD . Сумма индексов ACM_METRIC_COUNT_DRIVERS и ACM_METRIC_COUNT_DISABLED метрик — это общее количество глобально установленных драйверов ACM.
ACM_METRIC_COUNT_DRIVERS	Возвращаемое значение — общее количество включенных глобальных драйверов ACM (всех типов поддержки) в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_FILTERS	Возвращаемое значение — это количество глобальных драйверов фильтров ACM в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_HARDWARE	Возвращаемое значение — это количество глобальных аппаратных драйверов ACM в системе. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_LOCAL_CODECS	Возвращаемое значение — это количество локальных драйверов ACM, декомпрессорных драйверов ACM или обоих драйверов для вызывающей задачи. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_LOCAL_CONVERTERS	Возвращаемое значение — это количество драйверов локального преобразователя ACM для вызывающей задачи. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_LOCAL_DISABLED	Возвращаемое значение — общее количество локальных отключенных драйверов ACM всех типов поддержки для вызывающей задачи. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD . Сумма индексов метрик ACM_METRIC_COUNT_LOCAL_DRIVERS и ACM_METRIC_COUNT_LOCAL_DISABLED — это общее количество локально установленных драйверов ACM.
ACM_METRIC_COUNT_LOCAL_DRIVERS	Возвращаемое значение — общее количество включенных локальных драйверов ACM (всех типов поддержки) для вызывающей задачи. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_COUNT_LOCAL_FILTERS	Возвращаемое значение — это количество локальных драйверов фильтров ACM для вызывающей задачи. Параметр hao должен иметь значение NULL для этого индекса метрики. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_DRIVER_PRIORITY	Возвращаемое значение является текущим приоритетом для указанного драйвера. Параметр hao должен быть допустимым идентификатором драйвера ACM типа данных HACMDRIVERID . Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_DRIVER_SUPPORT	Возвращаемое значение — флаги fdwSupport для указанного драйвера. Параметр hao должен быть допустимым идентификатором драйвера ACM типа данных HACMDRIVERID . Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_HARDWARE_WAVE_INPUT	Возвращаемое значение — это идентификатор устройства ввода waveform-audio, связанный с указанным драйвером. Параметр hao должен быть допустимым идентификатором драйвера ACM типа данных HACMDRIVERID , поддерживающим флаг ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Если устройство ввода waveform-audio не связано с драйвером, возвращается MMSYSERR_NOTSUPPORTED. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_HARDWARE_WAVE_OUTPUT	Возвращаемое значение — это идентификатор устройства вывода waveform-audio, связанный с указанным драйвером. Параметр hao должен быть допустимым идентификатором драйвера ACM типа данных HACMDRIVERID , поддерживающим флаг ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Если устройство вывода waveform-audio не связано с драйвером, возвращается MMSYSERR_NOTSUPPORTED. Параметр pMetric должен указывать на буфер размером, равным значению DWORD .
ACM_METRIC_MAX_SIZE_FILTER	Возвращаемое значение — это размер самой большой структуры WAVEFILTER . Если hao имеет значение NULL, возвращаемое значение является самой большой структурой WAVEFILTER в системе. Если hao определяет открытый экземпляр драйвера ACM типа данных HACMDRIVER или идентификатор драйвера ACM типа данных HACMDRIVERID , возвращается самая большая структура WAVEFILTER для этого драйвера. Параметр pMetric должен указывать на буфер размером, равным значению DWORD . Эта метрика не допускается для дескриптора потока ACM типа данных HACMSTREAM .
ACM_METRIC_MAX_SIZE_FORMAT	Возвращаемое значение — это размер самой большой структуры WAVEFORMATEX . Если hao имеет значение NULL, возвращаемое значение является самой большой структурой WAVEFORMATEX в системе. Если hao определяет открытый экземпляр драйвера ACM типа данных HACMDRIVER или идентификатор драйвера ACM типа данных HACMDRIVERID , возвращается самая большая структура WAVEFORMATEX для этого драйвера. Параметр pMetric должен указывать на буфер размером, равным значению DWORD . Эта метрика не допускается для дескриптора потока ACM типа данных HACMSTREAM .

pMetric

Указатель на буфер для получения сведений о метриках. Точное определение зависит от индекса uMetric .

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

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

Код возврата	Описание
ACMERR_NOTPOSSIBLE	Индекс, указанный в uMetric , не может быть возвращен для указанного hao.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.
MMSYSERR_NOTSUPPORTED	Индекс, указанный в uMetric , не поддерживается.

Требования


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

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

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

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

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