EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION回呼函式 (acxelements.h)

驅動程式會實作 EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION 回呼，並在針對音訊引擎節點設定回送保護狀態時呼叫。

語法

EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION EvtAcxStreamaudioengineAssignLoopbackProtection;

NTSTATUS EvtAcxStreamaudioengineAssignLoopbackProtection(
  ACXSTREAMAUDIOENGINE StreamAudioEngine,
  ACX_CONSTRICTOR_OPTION ConstrictorOption
)
{...}

參數

StreamAudioEngine

現有、初始化的 ACXSTREAMAUDIOENGINE 物件。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

ConstrictorOption

指定數據流音訊引擎回送保護狀態 的ACX_CONSTRICTOR_OPTION 。 狀態可以設定為 AcxConstrictorOptionNone 或 AcxConstrictorOptionMute。 如果有任何作用中的數據流搭配 AcxConstrictorOptionMute 生效，則此音訊輸出的回送點選將會發出無聲。 如果所有作用中的數據流都有 AcxConstrictorOptionNone 生效，則回送點選包含有意義的數據。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

範例

範例使用方式如下所示。

EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION        CodecR_EvtAcxStreamAudioEngineAssignLoopbackProtection;

NTSTATUS
CodecR_EvtAcxStreamAudioEngineAssignLoopbackProtection(
    _In_    ACXSTREAMAUDIOENGINE    StreamAudioEngine,
    _In_    ACX_CONSTRICTOR_OPTION  ConstrictorOption
)
{
    NTSTATUS status = STATUS_INVALID_PARAMETER;
    ACXSTREAM stream;
    PCODEC_STREAM_CONTEXT ctx;
    CRenderStreamEngine * streamEngine = NULL;

    PAGED_CODE();

    stream = AcxStreamAudioEngineGetStream(StreamAudioEngine);
    if (stream)
    {
        ctx = GetCodecStreamContext(stream);

        streamEngine = static_cast<CRenderStreamEngine*>(ctx->StreamEngine);

        status = streamEngine->SetLoopbackProtection(ConstrictorOption);
    }

    return status;
}

ACX 需求

最低 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求	值
標頭	acxelements.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxelements.h 標頭