通过

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

另请参阅