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 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |