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 |
| IRQL | PASSIVE_LEVEL |