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

Статья
11/20/2024

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

Синтаксис

MMRESULT ACMAPI acmFormatDetailsA(
  HACMDRIVER          had,
  LPACMFORMATDETAILSA pafd,
  DWORD               fdwDetails
);

Параметры

had

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

pafd

Указатель на структуру ACMFORMATDETAILS, содержащую сведения о формате для данного тега формата.

fdwDetails

Флаги для получения сведений о теге формата waveform-audio. Определены следующие значения.

[ACMFORMATDETAILS]Структура (./nf-msacm-acmformatdetails.md) была предоставлена, а остальные сведения должны быть возвращены. Элемент dwFormatTag структуры ACMFORMATDETAIL S необходимо инициализировать в тот же тег формата, что и pwfx. Этот тип запроса можно использовать для получения строкового описания структуры произвольного формата. Если приложение указывает дескриптор драйвера ACM для , сведения о формате будут возвращены для этого драйвера. Если приложение указывает NULL для , ACM находит первый допустимый драйвер для возврата сведений.

Ценность	Значение
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Индекс формата для тега формата был дан в элементе dwFormatIndex члена структуре ACMFORMATDETAILS. Сведения о формате будут возвращены в структуре, определенной pafd. Индекс диапазонов от нуля до одного меньше, чем элемент cStandardFormats , возвращенный в структуре ACMFORMATTAGDETAILS для тега формата. Приложение должно указать дескриптор драйвера для при получении сведений о формате с этим флагом. Сведения о том, какие элементы следует инициализировать перед вызовом этой функции, см. в структуре ACMFORMATDETAILS.

Ценность

Значение

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Индекс формата для тега формата был дан в элементе dwFormatIndex члена структуре ACMFORMATDETAILS. Сведения о формате будут возвращены в структуре, определенной pafd. Индекс диапазонов от нуля до одного меньше, чем элемент cStandardFormats , возвращенный в структуре ACMFORMATTAGDETAILS для тега формата. Приложение должно указать дескриптор драйвера для при получении сведений о формате с этим флагом. Сведения о том, какие элементы следует инициализировать перед вызовом этой функции, см. в структуре ACMFORMATDETAILS.

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

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

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

Замечания

Заметка

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

Требования

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

См. также

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

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

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