AcxAudioEngineCreate 函式 (acxelements.h)

AcxAudioEngineCreate 函式是用來建立與線路 WDFDEVICE 裝置物件父系相關聯的音訊引擎。

語法

NTSTATUS AcxAudioEngineCreate(
  ACXCIRCUIT              Object,
  PWDF_OBJECT_ATTRIBUTES  Attributes,
  PACX_AUDIOENGINE_CONFIG Config,
  ACXAUDIOENGINE          *AudioEngine
);

參數

Object

WDFDEVICE 物件 (將與線路相關聯的 Framework 物件 摘要) 中所述。

Attributes

用來將 AcxAudioEngine 與父線路對象產生關聯的 WDF_OBJECT_ATTRIBUTES 結構。 請注意，其他 WDF 屬性，例如 WDF_EXECUTION_LEVEL 或 WDF_SYNCHRONIZATION_SCOPE，不應該使用 Attributes 參數來設定，因為它們是由 ACX 管理。

Config

描述音訊引擎組態的初始化 ACX_AUDIOENGINE_CONFIG結構 。

AudioEngine

接收轉譯線路中用來表示 DSP 之新 ACXAUDIOENGINE 物件句柄的位置指標。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

範例

範例使用方式如下所示。

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACX_AUDIOENGINE_CONFIG          audioEngineCfg;

    ACX_AUDIOENGINE_CONFIG_INIT(&audioEngineCfg);

    audioEngineCfg.HostPin = Pins[HostPin];
    audioEngineCfg.OffloadPin = Pins[OffloadPin];
    audioEngineCfg.LoopbackPin = Pins[LoopbackPin];
    audioEngineCfg.VolumeElement = volumeElement;
    audioEngineCfg.MuteElement = muteElement;
    audioEngineCfg.PeakMeterElement = peakmeterElement;
    audioEngineCfg.Callbacks = &audioEngineCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ENGINE_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxAudioEngineCreate(Circuit, &attributes, &audioEngineCfg, AudioEngine);

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

另請參閱

• acxelements.h 標頭