EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE função de retorno de chamada (acxelements.h)

  • Artigo

A função de retorno de chamada EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE é implementada pelo driver e é chamada quando o estado de efeitos globais é solicitado para o nó do mecanismo de áudio especificado.

Sintaxe

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;

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

Parâmetros

AudioEngine

O objeto ACXAUDIOENGINE para o qual o estado de efeitos globais foi solicitado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

State

Um valor ULONG que indica o estado de efeitos globais do nó do mecanismo de áudio especificado. Um valor diferente de zero indica que o processamento de efeito global no nó do mecanismo de áudio está habilitado e um valor 0 indica que o processamento de efeito global no nó do mecanismo de áudio está desabilitado.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Exemplo

O uso de exemplo é mostrado abaixo.

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;
}

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxelements.h
IRQL PASSIVE_LEVEL

Confira também