функция обратного вызова 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.

Remarks

Пример

Ниже приведен пример использования.

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

См. также раздел