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

  • Artigo

A função de retorno de chamada EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE é implementada pelo driver e é chamada quando o estado de efeitos globais é definido para um nó do mecanismo de áudio. O estado de efeitos globais pode ser definido como TRUE ou FALSE, em que TRUE indica que o processamento de efeito global no nó do mecanismo de áudio está habilitado e FALSE indica que o processamento de efeito global no nó do mecanismo de áudio está desabilitado.

Sintaxe

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;

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

Parâmetros

AudioEngine

Um objeto ACXAUDIOENGINE usado em um circuito de renderização para representar um DSP. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

State

O valor State é do tipo ULONG, mas é convertido no tipo BOOLEAN no retorno de chamada para indicar se o processamento de efeito global no nó do mecanismo de áudio está habilitado. Um valor true indica que o processamento está habilitado. FALSE indica que ele 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 _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;
}

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