AcxAudioEngineCreate 函式 （acxelements.h）

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

語法

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

參數

Object

WDFDEVICE 物件（如 Framework 物件的摘要所述），與線路相關聯。

Attributes

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

Config

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

AudioEngine

接收轉譯線路中所使用之新 ACXAUDIOENGINE 物件句柄的位置指標，表示 DSP。 如需 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 標頭