AcmFormatTagEnum

MMRESULT acmFormatTagEnum( HACMDRIVER had, LPACMFORMATTAGDETAILS paftd, ACMFORMATTAGENUMCB fnCallback, DWORD dwInstance, DWORD fdwEnum );

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

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

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

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

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

Аргументы

0. had — дескриптор драйвера ACM, для которого следует получить информацию о типе аудио формата. Если этот аргумент имеет нулевое значение, ACM передаёт информацию, касающуюся первого драйвера ACM, соответствующего выдвинутым требованиям.

1. paftd — указатель на объект структуры ACMFORMATTAGDETAILS, содержащей описание типа формата, передаваемого функции, определённой в аргументе fnCallback. При вызове в приложении функции acmFormatTagEnum в данном объекте структуры должна быть инициализирована переменная cbStruct.

2. fnCallback — указатель на экземпляр процедуры, определённой приложением в качестве функции обратного вызова.

3. dwInstance — определяемая в приложении 32-разрядная величина, передаваемая в качестве аргумента функции обратного вызова вместе с информацией о типе формата ACM.

4. fdwEnum — зарезервирован для дальнейшего использования и должен иметь нулевое значение.

Примечание

Функция acmFormatTagEnum производит поиск типов аудио форматов, используемых в драйвере ACM. Поиск после просмотра всех имеющихся типов форматов или в том случае, когда функция обратного вызова возвращает значение FALSE.

Функция acmFormatTagEnum должна возвращать значение MMSYSERR_NOERROR (нулевое), если не может быть использован ни один из установленных драйверов ACM. Кроме того, в этом случае не должна вызываться функция обратного вызова.

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

AcmFormatTagEnumCallback

BOOL ACMFORMATTAGENUMCB acmFormatTagEnumCallback( HACMDRIVERID hadid, LPACMFORMATTAGDETAILS paftd, DWORD dwInstance, DWORD fdwSupport );

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

Функция обратного вызова должна возвращать TRUE для продолжения поиска или FALSE для прекращения этой процедуры.

Аргументы

0. hadid — дескриптор идентификатора драйвера ACM.

1. paftd — указатель на объект структуры ACMFORMATTAGDETAILS, содержащий характеристики искомого типа формата.

2. dwInstance — переменная, определяемая в функции acmFormatTagEnum.

3. fdwSupport— флаги поддержки драйверов. Значение этого аргумента соответствует значению переменной fdwSupport объекта структуры ACMDRIVERDETAILS. Этот аргумент может являться комбинацией следующих флагов, определяющих какие операции драйвер может выполнить для данного типа фильтра:

• ACMDRIVERDETAILS_SUPPORTF_ASYNC — драйвер допускает асинхронное преобразование для данного типа фильтра.

• ACMDRIVERDETAILS_SUPPORTF_CODEC — драйвер допускает преобразование между двумя различными типами представления данных. Например, этот флаг устанавливается в том случае, когда драйвер допускает преобразование формата WAVE_FORMAT_PCM в формат WAVE_FORMAT_ADPCM.

• ACMDRIVERDETAILS_SUPPORTF_CONVERTER — драйвер допускает преобразование между двумя различными форматами одного типа представления данных. Например, этот флаг устанавливается в том случае, когда драйвер допускает изменение частоты дискретизации в формате WAVE_FORMAT_PCM.

• ACMDRIVERDETAILS_SUPPORTF_FILTER — драйвер допускает использование фильтра (изменение данных при сохранении формата их представления). Например, этот флаг устанавливается в том случае, когда драйвер допускает изменение уровня воспроизведения и добавление эха в формате WAVE_FORMAT_PCM.

• ACMDRIVERDETAILS_SUPPORTF_HARDWARE — драйвер позволяет производить аппаратный ввод, вывод или одновременный ввод и вывод через аудио устройство. Для получения идентификаторов устройств, связанных с поддерживаемым драйвером ACM приложение должно вызвать функцию acmMetrics с индексами метрики ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT.

Примечание

Функция acmFormatTagEnumCallback представляет собой функцию обратного вызова, используемую в функции acmFormatTagEnum. Имя функции acmFormatTagEnumCallback является условным и может быть заменено другим именем, не используемым другими функциями.

Функция acmFormatTagEnum должна возвращать значение MMSYSERR_NOERROR (нулевое), если не может быть найден ни один из типов форматов. Кроме того, в этом случае не должна вызываться функция обратного вызова.

Из функции обратного вызова не должны вызваться функции acmDriverAdd, acmDriverRemove и acmDriverPriority.

Описание данной функции содержится в файле заголовка msacm.h.