EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE funzione di callback (acxelements.h)

La EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE funzione di callback viene implementata dal driver e viene chiamata quando lo stato degli effetti globali viene impostato per un nodo del motore audio. Lo stato degli effetti globali può essere impostato su TRUE o FALSE, dove TRUE indica che l'elaborazione dell'effetto globale nel nodo del motore audio è abilitata e FALSE indica che l'elaborazione dell'effetto globale nel nodo del motore audio è disabilitata.

Sintassi

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;

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

Parametri

AudioEngine

Oggetto ACXAUDIOENGINE utilizzato in un circuito di rendering per rappresentare un DSP. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

State

Il valore State è di tipo ULONG, ma viene convertito in tipo BOOLEAN nel callback per indicare se l'elaborazione dell'effetto globale nel nodo del motore audio è abilitata. Il valore TRUE indica che l'elaborazione è abilitata. FALSE indica che è disabilitato.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Esempio

Di seguito è riportato un esempio di utilizzo.

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

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Vedi anche

• Intestazione acxelements.h