EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE função de retorno de chamada (acxelements.h)
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 de Estado é do tipo ULONG, mas é convertido para o 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.
Valor de retorno
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.
Observações
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 |