Функция обратного вызова ACMDRIVERENUMCB (msacm.h)
Функция acmDriverEnumCallback указывает функцию обратного вызова, используемую с функцией acmDriverEnum . Имя acmDriverEnumCallback является заполнителем для имени функции, определяемой приложением.
Синтаксис
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Параметры
hadid
Обработка идентификатора драйвера ACM.
dwInstance
Определяемое приложением значение, указанное в acmDriverEnum.
fdwSupport
Флаги поддержки драйверов, относящиеся к драйверу, указанному в структуре ACMDRIVERDETAILS . Этот параметр может быть сочетанием следующих значений.
| Значение | Значение |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Драйвер поддерживает асинхронные преобразования. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Драйвер поддерживает преобразование между двумя различными тегами формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Драйвер поддерживает преобразование двух разных форматов одного и того же тега формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM, этот флаг устанавливается. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | Драйвер отключен. Чтобы включить отключенные драйверы в перечисление, приложение должно указать флаг ACM_DRIVERENUMF_DISABLED с помощью acmDriverEnum . |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эха в WAVE_FORMAT_PCM, этот флаг устанавливается. |
Возвращаемое значение
Функция обратного вызова должна возвращать значение TRUE , чтобы продолжить перечисление, или FALSE , чтобы остановить перечисление.
Комментарии
Функция acmDriverEnum возвращает MMSYSERR_NOERROR (ноль), если драйверы ACM не установлены. Кроме того, функция обратного вызова вызываться не будет.
Из функции обратного вызова не следует вызывать следующие функции: acmDriverAdd, acmDriverRemove и acmDriverPriority.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | msacm.h |