структура ACX_AUDIOENGINE_CONFIG (acxelements.h)

Статья
02/26/2024

Структура ACX_AUDIOENGINE_CONFIG используется для определения конфигурации звукового модуля.

Синтаксис

typedef struct _ACX_AUDIOENGINE_CONFIG {
  ULONG                      Size;
  ULONG                      Id;
  const GUID                 *Name;
  ULONG                      Flags;
  ACXPIN                     HostPin;
  ACXPIN                     OffloadPin;
  ACXPIN                     LoopbackPin;
  ACXVOLUME                  VolumeElement;
  ACXMUTE                    MuteElement;
  ACXPEAKMETER               PeakMeterElement;
  PACX_AUDIOENGINE_CALLBACKS Callbacks;
} ACX_AUDIOENGINE_CONFIG, *PACX_AUDIOENGINE_CONFIG;

Члены

Size

Длина этой структуры в байтах.

Id

Число, представляющее идентификатор элемента.

Name

Указатель на GUID, представляющий имя элемента. Может использоваться для отладки и по умолчанию GUID_NULL, если не указан.

Flags

Флаги конфигурации обработчика звука, определенные перечислением ACX_AUDIOENGINE_CONFIG_FLAGS.

В настоящее время биты флагов не определены. Задайте для этого элемента значение 0 — AcxAudioEngineConfigNoFlags

HostPin

Существующий объект ACXPIN, который служит в качестве узла для обработчика звука. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

OffloadPin

Существующий объект ACXPIN, представляющий контакт разгрузки.

LoopbackPin

Существующий объект ACXPIN, представляющий контакт замыкания на себя.

VolumeElement

Существующий объект ACXVOLUME, используемый для операций с громкостью звукового модуля.

MuteElement

Существующий объект ACXMUTE, который используется для выключения звука обработчиком звука.

PeakMeterElement

Существующий объект ACXPEAKMETER, используемый для пиковых операций звукового модуля.

Callbacks

Структура ACX_AUDIOENGINE_CALLBACKS, которая определяет обратные вызовы для обработчика звука.

Remarks

Пример

Ниже приведен пример использования.

    ACX_AUDIOENGINE_CONFIG          audioEngineCfg;  
    ACX_AUDIOENGINE_CALLBACKS       audioEngineCallbacks;

    // Initialize the config structure
    ACX_AUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
    // Set the values of the structure
    audioEngineCfg.HostPin = Pins[HostPin];
    audioEngineCfg.OffloadPin = Pins[OffloadPin];
    audioEngineCfg.LoopbackPin = Pins[LoopbackPin];
    audioEngineCfg.VolumeElement = volumeElement;
    audioEngineCfg.MuteElement = muteElement;
    audioEngineCfg.PeakMeterElement = peakmeterElement;
    audioEngineCfg.Callbacks = &audioEngineCallbacks;

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование	Значение
Заголовок	acxelements.h

См. также раздел

[заголовок acxelements.h] (index.md)

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