функция обратного вызова EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE (acxelements.h)

Функция обратного вызова EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE реализуется драйвером и вызывается, когда для узла подсистемы аудиозаписи задано состояние глобальных эффектов. Состояние глобальных эффектов может быть задано как TRUE или FALSE, где значение TRUE указывает, что глобальная обработка эффектов в узле звукового модуля включена, а ЗНАЧЕНИЕ FALSE указывает, что глобальная обработка эффектов в узле звукового модуля отключена.

Синтаксис

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;

NTSTATUS EvtAcxAudioengineAssignEffectsState(
  ACXAUDIOENGINE AudioEngine,
  ULONG State
)
{...}

Параметры

AudioEngine

Объект ACXAUDIOENGINE, используемый в канале отрисовки для представления DSP. Дополнительные сведения о объектах ACX см. в сводке по объектам ACX.

State

Значение State имеет тип ULONG, но преобразуется в тип BOOLEAN в обратном вызове, чтобы указать, включена ли глобальная обработка эффектов в узле подсистемы аудио. Значение TRUE указывает, что включена обработка. FALSE указывает, что он отключен.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.

Замечания

Пример

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

typedef struct _DSP_ENGINE_CONTEXT
{
    ACXDATAFORMAT MixFormat;
    BOOLEAN GFxEnabled;
} DSP_ENGINE_CONTEXT, *PDSP_ENGINE_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(DSP_ENGINE_CONTEXT, GetDspEngineContext)

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE        DspR_EvtAcxAudioEngineAssignEffectsState;

NTSTATUS
DspR_EvtAcxAudioEngineAssignEffectsState(
    ACXAUDIOENGINE  AudioEngine,
    ULONG           State
)
{
    PAGED_CODE();
    
    PDSP_ENGINE_CONTEXT   pAudioEngineCtx;
    pAudioEngineCtx = GetDspEngineContext(AudioEngine);

    pAudioEngineCtx->GFxEnabled = (BOOLEAN)State;

    return STATUS_SUCCESS;
}

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

См. также

• acxelements.h заголовок