Структура ACMFORMATTAGDETAILS (msacm.h)
Структура ACMFORMATTAGDETAILS содержит тег формата waveform-audio для драйвера ACM.
Синтаксис
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
Члены
cbStruct
Размер структуры ACMFORMATTAGDETAILS в байтах . Этот элемент необходимо инициализировать, прежде чем приложение вызовет функцию acmFormatTagDetails или acmFormatTagEnum . Размер, заданный этим элементом, должен быть достаточно большим, чтобы содержать базовую структуру ACMFORMATTAGDETAILS . При возвращении функции acmFormatTagDetails этот элемент содержит фактический размер возвращаемых сведений. Возвращаемые сведения никогда не будут превышать запрошенный размер.
dwFormatTagIndex
Индекс тега формата, для которого будут получены сведения. Индекс в диапазоне от нуля до единицы меньше, чем количество тегов формата, поддерживаемых драйвером ACM. Количество тегов формата, поддерживаемых драйвером, содержится в структуре ACMDRIVERDETAILS . Член dwFormatTagIndex используется только при запросе сведений о теге формата в драйвере по индексу; В противном случае этот элемент должен быть равен нулю.
dwFormatTag
Тег формата Waveform-audio, описывающий структуру ACMFORMATTAGDETAILS . Этот элемент используется для ввода флагов ACM_FORMATTAGDETAILSF_FORMATTAG и ACM_FORMATTAGDETAILSF_LARGESTSIZE запросов. Если функция acmFormatTagDetails выполнена успешно, этот элемент всегда возвращается. Для этого элемента должно быть задано значение WAVE_FORMAT_UNKNOWN для всех остальных флагов запроса.
cbFormatSize
Максимальный общий размер (в байтах) формата waveform-audio типа dwFormatTag . Например, этот элемент будет иметь значение 16 для WAVE_FORMAT_PCM и 50 для WAVE_FORMAT_ADPCM.
fdwSupport
Флаги поддержки драйверов, относящиеся к тегу формата. Эти флаги идентичны структуре ACMDRIVERDETAILS . Этот элемент может быть сочетанием следующих значений и ссылаться на операции, поддерживаемые драйвером, с тегом format:
| Имя | Описание |
|---|---|
|
Драйвер поддерживает асинхронные преобразования с указанным тегом формата. |
|
Драйвер поддерживает преобразование между двумя различными тегами формата, где один из тегов является указанным тегом формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается. |
|
Драйвер поддерживает преобразование между двумя разными форматами указанного тега формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM, этот флаг устанавливается. |
|
Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эха для указанного тега формата, этот флаг устанавливается. |
|
Драйвер поддерживает аппаратный ввод, вывод или оба указанных тега формата через устройство waveform-audio. Приложение должно использовать функцию acmMetrics с ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT индексами метрик, чтобы получить идентификаторы устройства waveform-audio, связанные с поддерживающим драйвером ACM. |
cStandardFormats
Число стандартных форматов типа dwFormatTag ; то есть сочетание всех частот выборки, битов на выборку, каналов и т. д. Это значение может указывать все форматы, поддерживаемые драйвером, но не обязательно.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
Строка, описывающая тип dwFormatTag . Если функция acmFormatTagDetails выполнена успешно, эта строка всегда возвращается.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | msacm.h |