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 標頭