Функция AcxStreamAudioEngineCreate (acxelements.h)

Статья
10/05/2023

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

Синтаксис

NTSTATUS AcxStreamAudioEngineCreate(
  ACXSTREAM                     Stream,
  ACXAUDIOENGINE                AudioEngine,
  PWDF_OBJECT_ATTRIBUTES        Attributes,
  PACX_STREAMAUDIOENGINE_CONFIG Config,
  ACXSTREAMAUDIOENGINE          *StreamAudioEngine
);

Параметры

Stream

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

AudioEngine

Объект ACXAUDIOENGINE, используемый в цепи отрисовки для представления DSP. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Attributes

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

Config

Инициализированная структура ACX_STREAMAUDIOENGINE_CONFIG , описывающая конфигурацию подсистемы потоковой передачи звука.

StreamAudioEngine

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

Возвращаемое значение

Возвращает значение STATUS_SUCCESS , если вызов был успешным. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

Remarks

Пример

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

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACXSTREAM                       stream;
    ACXELEMENT                      elements[2] = {0};
    ACX_STREAMAUDIOENGINE_CONFIG    audioEngineCfg;

        ACX_STREAMAUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
        audioEngineCfg.VolumeElement = volumeElement;
        audioEngineCfg.MuteElement = muteElement;
        audioEngineCfg.PeakMeterElement = peakmeterElement;
        audioEngineCfg.Callbacks = &streamAudioEngineCallbacks;

        WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_STREAMAUDIOENGINE_CONTEXT);
        attributes.ParentObject = stream;

        status = AcxStreamAudioEngineCreate(stream, circuitCtx->AudioEngineElement, &attributes, &audioEngineCfg, (ACXSTREAMAUDIOENGINE*)&elements[0]);

Требования ACX

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

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

Требования

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

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

Заголовок acxelements.h