функция acmFormatTagDetailsW (msacm.h)

Статья
11/20/2024

Функция acmFormatTagDetails запрашивает ACM для получения сведений о конкретном теге формата волны-аудио.

Синтаксис

MMRESULT ACMAPI acmFormatTagDetailsW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD                  fdwDetails
);

Параметры

had

Обработайте драйвер ACM для запроса сведений о теге формата waveform-audio. Если этот параметр null, ACM использует сведения из первого подходящего драйвера ACM. Приложение должно указать допустимый дескриптор или идентификатор драйвера при использовании типа запроса ACM_FORMATTAGDETAILSF_INDEX. Идентификаторы драйверов для отключенных драйверов не допускаются.

paftd

Указатель на структуру ACMFORMATTAGDETAILS, которая требует получения сведений о теге формата.

fdwDetails

Флаги для получения сведений. Определены следующие значения.

[ACMFORMATTAGDETAILS]Структура (./nf-msacm-acmformattagdetails.md). Сведения о теге формата будут возвращены в структуре, на которую указывает paftd. Если приложение указывает дескриптор драйвера ACM для , сведения о теге формата будут возвращены для этого драйвера. Если приложение указывает NULL для , ACM находит первый допустимый драйвер для возврата сведений. [ACMDRIVERDETAILS]Структура (./nf-msacm-acmdriverdetails.md) для драйвера ACM. Приложение должно указать дескриптор драйвера для при получении сведений о теге формата с этим флагом. [ACMFORMATTAGDETAILS]Структура (./nf-msacm-acmformattagdetails.md) должна быть WAVE_FORMAT_UNKNOWN или тег формата, чтобы найти самый большой размер. Если приложение указывает дескриптор драйвера ACM для , сведения о самом большом теге формата будут возвращены для этого драйвера. Если приложение указывает NULL для , ACM находит приемлемый драйвер с наибольшим тегом формата, запрошенным для возврата сведений.

Ценность	Значение
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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

Возвращает ноль в случае успешного выполнения или ошибки в противном случае. Возможные значения ошибок включают следующие значения.

Возвращаемый код	Описание
ACMERR_NOTPOSSIBLE	Запрошенные сведения недоступны.
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.

Замечания

Заметка

Заголовок msacm.h определяет ACMFORMATTAGDETAILS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	msacm.h
библиотеки	Msacm32.lib
DLL	Msacm32.dll

См. также

Функции сжатия звука

диспетчер сжатия звука

Поделиться через