Compartilhar via


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

A função de retorno de chamada EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE é implementada pelo driver e é chamada quando o estado de efeitos locais é solicitado para o mecanismo de áudio de fluxo especificado.

Sintaxe

EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxStreamaudioengineRetrieveEffectsState;

NTSTATUS EvtAcxStreamaudioengineRetrieveEffectsState(
  ACXSTREAMAUDIOENGINE StreamAudioEngine,
  PULONG State
)
{...}

Parâmetros

StreamAudioEngine

Um objeto ACXSTREAMAUDIOENGINE existente, inicializado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

State

Um valor ULONG que indica se o processamento de efeito local no nó do mecanismo de áudio de fluxo está habilitado. Um valor diferente de zero indica que o processamento está habilitado. Um valor igual a 0 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.

EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE            DspR_EvtAcxStreamAudioEngineRetrieveEffectsState;

NTSTATUS
DspR_EvtAcxStreamAudioEngineRetrieveEffectsState(
    ACXSTREAMAUDIOENGINE    StreamAudioEngine,
    PULONG                  State
)
{
    PAGED_CODE();

    PDSP_STREAMAUDIOENGINE_CONTEXT pStreamAudioEngineCtx;
    pStreamAudioEngineCtx = GetDspStreamAudioEngineContext(StreamAudioEngine);

    *State = pStreamAudioEngineCtx->LFxEnabled;

    return STATUS_SUCCESS;
}

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as 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