Функция обратного вызова ACMFORMATENUMCBA (msacm.h)
Функция acmFormatEnumCallback указывает функцию обратного вызова, используемую с функцией acmFormatEnum . Имя acmFormatEnumCallback — это заполнитель для имени определяемой приложением функции.
Синтаксис
ACMFORMATENUMCBA Acmformatenumcba;
BOOL Acmformatenumcba(
HACMDRIVERID hadid,
LPACMFORMATDETAILSA pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Параметры
hadid
Дескриптор идентификатора драйвера ACM.
pafd
Указатель на структуру ACMFORMATDETAILS , содержащую перечисленные сведения о формате для тега формата.
dwInstance
Определяемое приложением значение, указанное в функции acmFormatEnum .
fdwSupport
Драйвер поддерживает флаги, относящиеся к драйверу, определяемого структурой ACMDRIVERDETAILS , но они зависят от перечисляемого формата. Этот параметр может быть сочетанием следующих значений и указывает, какие операции драйвер поддерживает для тега format.
Значение | Значение |
---|---|
ACMDRIVERDETAILS_SUPPORTF_ASYNC | Драйвер поддерживает асинхронные преобразования с указанным тегом фильтра. |
ACMDRIVERDETAILS_SUPPORTF_CODEC | Драйвер поддерживает преобразование между двумя разными тегами формата для указанного формата. Например, если драйвер поддерживает сжатие из WAVE_FORMAT_PCM в WAVE_FORMAT_ADPCM с указанным форматом, этот флаг устанавливается. |
ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Драйвер поддерживает преобразование между двумя разными форматами одного и того же тега формата при использовании указанного формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM в указанный формат, этот флаг устанавливается. |
ACMDRIVERDETAILS_SUPPORTF_FILTER | Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата) с указанным форматом. Например, если драйвер поддерживает операции тома или эха на WAVE_FORMAT_PCM, этот флаг устанавливается. |
ACMDRIVERDETAILS_SUPPORTF_HARDWARE | Драйвер поддерживает аппаратные входные, выходные данные или оба указанных тега формата через устройство waveform-audio. Приложение должно использовать функцию acmMetrics с ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT индексы метрик, чтобы получить идентификаторы устройств waveform-audio, связанные с поддерживающим драйвером ACM. |
Возвращаемое значение
Функция обратного вызова должна возвращать значение TRUE , чтобы продолжить перечисление, или FALSE , чтобы остановить перечисление.
Комментарии
Функция acmFormatEnum возвращает MMSYSERR_NOERROR (ноль), если не требуется перечисление форматов. Кроме того, функция обратного вызова вызываться не будет.
Из функции обратного вызова не следует вызывать следующие функции: acmDriverAdd, acmDriverRemove и acmDriverPriority.
Примечание
Заголовок msacm.h определяет ACMFORMATENUMCB в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | msacm.h |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по