AcxStreamAudioEngineCreate 函式 (acxelements.h)
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值。
備註
範例
範例使用方式如下所示。
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 |