AcmFormatTagDetails

MMRESULT acmFormatTagDetails( HACMDRIVER had, LPACMFORMATTAGDETAILS paftd, DWORD fdwDetails );

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

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

• ACMERR_NOTPOSSIBLE — требуемая информация не может быть получена.

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

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

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

Аргументы

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

1. paftd — указатель на объект структуры ACMFORMATTAGDETAILS, в который будет записана информация о типе формата.

2. fdwDetails — набор флагов, определяющих характер получаемой информации. Определены следующие значения:

• ACM_FORMATTAGDETAILSF_FORMATTAG — тип формата задан в переменной dwFormatTag объекта структуры ACMFORMATTAGDETAILS. Информация по указанному типу формата будет помещена в объект структуры, на который указывает аргумент paftd. Если в аргументе had содержится дескриптор драйвера ACM, то информация о типе формата будет возвращаться данным драйвером. Если аргумент had имеет нулевое значение, ACM производит поиск первого драйвера, соответствующего выдвинутым требованиям, и возвращает информация о типе формата, содержащуюся в данном драйвере.

• ACM_FORMATTAGDETAILSF_INDEX — индекс типа формата передаётся в переменной dwFormatTagIndex объекта структуры ACMFORMATTAGDETAILS. Тип формата и информация о нём будет помещена в объект структуры, на который указывает аргумент paftd. Индекс может принимать любое значение от нуля до значения, на единицу меньшего значения переменной cFormatTags объекта структуры ACMDRIVERDETAILS для данного драйвера ACM. При установке данного флага приложение должно передать в аргументе had дескриптор драйвера для требуемого типа формата.

• ACM_FORMATTAGDETAILSF_LARGESTSIZE — должна быть получена информация по типу формата, имеющего максимальный размер в байтах. В переменной dwFormatTag объекта структуры ACMFORMATTAGDETAILS следует указать значение WAVE_FORMAT_UNKNOWN или тип формата, для которого следует найти максимальный размер. Если в аргументе had передаётся дескриптор драйвера ACM, то информация о максимальном размере типа формата будет касаться данного драйвера. Если аргумент had имеет нулевое значение, то ACM производит поиск драйвера, соответствующего выдвинутым требованиям и имеющего максимальный размер типа формата, и возвращает информацию о нём.

Примечание

Функция acmFormatTagDetails позволяет получить информацию об указанном типе формата аудио информации в ACM.

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