AcmMetrics

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

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

В случае успешного завершения возвращает нулевое значение. В противном случае возвращает одно из следующих значений:

• MMSYSERR_INVALHANDLE — использован недопустимый дескриптор.

• MMSYSERR_INVALPARAM — при вызове данной функции, по крайней мере, один из её аргументов имеет недопустимое значение.

• ACMERR_NOTPOSSIBLE — индекс, переданный в аргументе uMetric не может быть возвращён для дескриптора, переданного в аргументе hao.

• MMSYSERR_NOTSUPPORTED — индекс, переданный в аргументе uMetric не может быть обработан.

Аргументы

0. hao — дескриптор объекта ACM, для которого запрашивается метрика, определённая в аргументе uMetric. При некоторых запросах данный аргумент может принимать нулевое значение.

1. uMetric — индекс метрики, возвращаемой в аргументе pMetric.

• ACM_METRIC_COUNT_CODECS — возвращается общее число компрессоров и декомпрессоров ACM, установленных в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_CONVERTERS — возвращается общее число драйверов голобальных преобразователей ACM в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_DISABLED — возвращается общее число недоступных глобальных драйверов ACM (всех используемых типов) в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова. Сумма значений, возвращаемых по индексам метрики ACM_METRIC_COUNT_DRIVERS и ACM_METRIC_COUNT_DISABLED соответствует общему числу установленных в системе глобальных драйверов ACM.

• ACM_METRIC_COUNT_DRIVERS — возвращается общее число доступных глобальных драйверов ACM (всех используемых типов) в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_FILTERS — возвращается общее число драйверов глобальных фильтров ACM, установленных в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_HARDWARE — возвращается общее число глобальных аппаратных драйверов ACM, установленных в системе. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_LOCAL_CODECS — возвращается общее число локальных драйверов компрессоров ACM, драйверов декомпрессоров ACM или драйверов, позволяющих осуществить обе эти операции, установленных для данной задачи. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_LOCAL_CONVERTERS — возвращается общее число локальных драйверов преобразователей ACM, установленных для данной задачи. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_LOCAL_DISABLED — возвращается общее число недоступных локальных драйверов ACM всех используемых типов, установленных для данной задачи. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова. Сумма значений, возвращаемых по индексам метрики ACM_METRIC_COUNT_LOCAL_DRIVERS и ACM_METRIC_COUNT_LOCAL_DISABLED соответствует общему числу установленных в системе локальных драйверов ACM.

• ACM_METRIC_COUNT_LOCAL_DRIVERS — возвращается общее число доступных локальных драйверов ACM всех используемых типов, установленных для данной задачи. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_COUNT_LOCAL_FILTERS — возвращается общее число доступных драйверов локальных фильтров ACM, установленных для данной задачи. При указании данного индекса метрики аргумент hao должен иметь нулевое значение. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_DRIVER_PRIORITY — возвращается текущий уровень приоритета для указанного драйвера. При указании данного индекса метрики аргумент hao должен содержать корректный идентификатор драйвера ACM, имеющий тип HACMDRIVERID. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_DRIVER_SUPPORT — возвращаются установки флагов в переменной fdwSupport для указанного драйвера. При указании данного индекса метрики аргумент hao должен содержать корректный идентификатор драйвера ACM, имеющий тип HACMDRIVERID. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_HARDWARE_WAVE_INPUT — возвращается значение идентификатора устройства ввода аудио информации, связанного с указанным драйвером. При указании данного индекса метрики аргумент hao должен содержать корректный идентификатор драйвера ACM, имеющий тип HACMDRIVERID, для которого может быть установлен флаг ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Если с указанным драйвером не связано но одно устройство ввода аудио информации, данная функция возвращает значение MMSYSERR_NOTSUPPORTED. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_HARDWARE_WAVE_OUTPUT — возвращается значение идентификатора устройства вывода аудио информации, связанного с указанным драйвером. При указании данного индекса метрики аргумент hao должен содержать корректный идентификатор драйвера ACM, имеющий тип HACMDRIVERID, для которого может быть установлен флаг ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Если с указанным драйвером не связано но одно устройство вывода аудио информации, данная функция возвращает значение MMSYSERR_NOTSUPPORTED. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова.

• ACM_METRIC_MAX_SIZE_FILTER — возвращается максимальный размер объекта структуры WAVEFILTER. Если аргумент hao имеет нулевое значение, возвращается максимальный размер объекта структуры WAVEFILTER, используемого в системе. Если в аргументе hao содержится идентификатор открытого экземпляра драйвера ACM, имеющий тип HACMDRIVER, или идентификатор драйвера ACM, имеющий тип HACMDRIVERID, возвращается максимальный размер объекта структуры WAVEFILTER, используемого указанным драйвером. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова. Эта метрика не может быть получена для дескриптора потока ACM, имеющего тип HACMSTREAM.

• ACM_METRIC_MAX_SIZE_FORMAT — возвращается максимальный размер объекта структуры WAVEFORMATEX. Если аргумент hao имеет нулевое значение, возвращается максимальный размер объекта структуры WAVEFORMATEX, используемого в системе. Если в аргументе hao содержится идентификатор открытого экземпляра драйвера ACM, имеющий тип HACMDRIVER, или идентификатор драйвера ACM, имеющий тип HACMDRIVERID, возвращается максимальный размер объекта структуры WAVEFORMATEX, используемого указанным драйвером. Аргумент pMetric должен указывать на буфер, имеющий размер двойного слова. Эта метрика не может быть получена для дескриптора потока ACM, имеющего тип HACMSTREAM.

0. pMetric — указатель на буфер, в который будет записано значение запрошенной метрики. Интерпретация записанного значения зависит от значения аргумента uMetric.

Примечание

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

Описание данной функции содержится в файле заголовка msacm.h. При работе с данной функцией следует включить в проект библиотеку msacm32.lib.