EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE Rückruffunktion (acxelements.h)
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 |