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 Effektstatus für einen Audiomodulknoten festgelegt wird. Der Status der globalen Effekte kann auf WAHR oder FALSCH festgelegt werden, wobei WAHR angibt, dass die globale Effektverarbeitung im Audiomodulknoten aktiviert ist, und FALSE gibt an, dass die globale Effektverarbeitung im Audiomodulknoten deaktiviert ist.
Syntax
EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;
NTSTATUS EvtAcxAudioengineAssignEffectsState(
ACXAUDIOENGINE AudioEngine,
ULONG State
)
{...}
Parameter
AudioEngine
Ein ACXAUDIOENGINE-Objekt, das in einem Renderkreis verwendet wird, um einen DSP darzustellen. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.
State
Der Statuswert ist vom Typ ULONG, wird jedoch im Rückruf in den Typ BOOLEAN konvertiert, um anzugeben, ob die globale Effektverarbeitung im Audiomodulknoten aktiviert ist. Ein Wert von TRUE gibt an, dass die Verarbeitung aktiviert ist. FALSE gibt an, dass sie deaktiviert ist.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Die Beispielverwendung wird unten gezeigt.
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
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxelements.h |
| IRQL- | PASSIVE_LEVEL |