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

  • Статья

Функция 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

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

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

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