EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE Rückruffunktion (acxelements.h)

  • Artikel

Die EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE Rückruffunktion wird vom Treiber implementiert und aufgerufen, wenn der Globale Effektzustand für einen Audiomodulknoten festgelegt ist. Der status der globalen Effekte kann auf TRUE oder FALSE festgelegt werden, wobei TRUE angibt, dass die globale Effektverarbeitung im Audio-Engine-Knoten aktiviert ist und FALSE angibt, dass die globale Effektverarbeitung im Knoten der Audio-Engine deaktiviert ist.

Syntax

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;

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

Parameter

AudioEngine

Ein ACXAUDIOENGINE-Objekt, das in einer Renderschaltung verwendet wird, um einen DSP darzustellen. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

State

Der State-Wert ist vom Typ ULONG, wird aber im Rückruf in den Typ BOOLEAN konvertiert, um anzugeben, ob die globale Effektverarbeitung im Audio-Engine-Knoten aktiviert ist. Der Wert TRUE gibt an, dass die Verarbeitung aktiviert ist. FALSE gibt an, dass es deaktiviert ist.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

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

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxelements.h
IRQL PASSIVE_LEVEL

Weitere Informationen