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

Статья
02/06/2025

Структура 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 перечисления.

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

HostPin

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

OffloadPin

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

LoopbackPin

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

VolumeElement

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

MuteElement

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

PeakMeterElement

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

Callbacks

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

Замечания

Пример

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

    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 header](index.md)

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