Прочитать на английском

Поделиться через

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

  • Статья

Функция обратного вызова EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE реализуется драйвером и вызывается при запросе состояния глобальных эффектов для указанного узла звукового модуля.

Синтаксис

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;

NTSTATUS EvtAcxAudioengineRetrieveEffectsState(
  ACXAUDIOENGINE AudioEngine,
  PULONG State
)
{...}

Параметры

AudioEngine

Объект ACXAUDIOENGINE, для которого запрашивается состояние глобальных эффектов. Дополнительные сведения о объектах ACX см. в сводке по объектам ACX.

State

Значение ULONG, указывающее состояние глобальных эффектов указанного узла звукового модуля. Значение, отличное от нуля, указывает, что глобальная обработка эффектов в узле звукового модуля включена, а значение 0 указывает, что глобальная обработка эффектов в узле звукового модуля отключена.

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

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

Замечания

Пример

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

typedef struct _CODEC_ENGINE_CONTEXT {
    ACXDATAFORMAT   MixFormat;
    BOOLEAN         GFxEnabled;
} CODEC_ENGINE_CONTEXT, *PCODEC_ENGINE_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_ENGINE_CONTEXT, GetCodecEngineContext)

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE      Codec_EvtAcxAudioEngineRetrieveEffectsState;

NTSTATUS
Codec_EvtAcxAudioEngineRetrieveEffectsState(
    _In_    ACXAUDIOENGINE  AudioEngine,
    _Out_   PULONG          State
)
{
    PAGED_CODE();

    PCODEC_ENGINE_CONTEXT   pAudioEngineCtx;
    pAudioEngineCtx = GetCodecEngineContext(AudioEngine);

    *State = pAudioEngineCtx->GFxEnabled;

    return STATUS_SUCCESS;
}

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

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

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

Требования

Требование Ценность
заголовка acxelements.h
IRQL PASSIVE_LEVEL

См. также