Структура ACMFORMATTAGDETAILS (msacm.h)

Статья
08/24/2023

Структура 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:

Имя	Описание
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Драйвер поддерживает асинхронные преобразования с указанным тегом формата.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Драйвер поддерживает преобразование между двумя различными тегами формата, где один из тегов является указанным тегом формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Драйвер поддерживает преобразование между двумя разными форматами указанного тега формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эха для указанного тега формата, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Драйвер поддерживает аппаратный ввод, вывод или оба указанных тега формата через устройство 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

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

ACMDRIVERDETAILS

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

Структуры сжатия звука

acmFormatTagDetails

acmFormatTagEnum

acmMetrics