Функция обратного вызова ACMFORMATTAGENUMCB (msacm.h)
Функция acmFormatTagEnumCallback указывает функцию обратного вызова, используемую с функцией acmFormatTagEnum . Имя acmFormatTagEnumCallback — это заполнитель для имени определяемой приложением функции.
Синтаксис
ACMFORMATTAGENUMCB Acmformattagenumcb;
BOOL Acmformattagenumcb(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILS paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Параметры
hadid
Дескриптор идентификатора драйвера ACM.
paftd
Указатель на структуру ACMFORMATTAGDETAILS , содержащую сведения о теге перечисленного формата.
dwInstance
Определяемое приложением значение, указанное в функции acmFormatTagEnum .
fdwSupport
Флаги поддержки драйверов, относящиеся к тегу format. Эти флаги идентичны структуре 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 индексы метрик, чтобы получить идентификаторы звукового устройства, связанные с поддерживающим драйвером ACM. |
Возвращаемое значение
Функция обратного вызова должна возвращать значение TRUE , чтобы продолжить перечисление, или FALSE , чтобы остановить перечисление.
Комментарии
Функция acmFormatTagEnum возвращает MMSYSERR_NOERROR (ноль), если не нужно перечислить теги формата. Кроме того, функция обратного вызова вызываться не будет.
Из функции обратного вызова не следует вызывать следующие функции: acmDriverAdd, acmDriverRemove и acmDriverPriority.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | msacm.h |