EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE fonction de rappel (acxelements.h)
La fonction de rappel EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE est implémentée par le pilote et est appelée lorsque l’état des effets globaux est défini pour un nœud de moteur audio. L’état des effets globaux peut être défini sur TRUE ou FALSE, où TRUE indique que le traitement global des effets dans le nœud du moteur audio est activé et FALSE indique que le traitement global des effets dans le nœud du moteur audio est désactivé.
Syntaxe
EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;
NTSTATUS EvtAcxAudioengineAssignEffectsState(
ACXAUDIOENGINE AudioEngine,
ULONG State
)
{...}
Paramètres
AudioEngine
Objet ACXAUDIOENGINE utilisé dans un circuit de rendu pour représenter un DSP. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
State
La valeur State est de type ULONG, mais est convertie en type BOOLEAN dans le rappel pour indiquer si le traitement global des effets dans le nœud du moteur audio est activé. La valeur TRUE indique que le traitement est activé. FALSE indique qu’il est désactivé.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Exemple
L’exemple d’utilisation est illustré ci-dessous.
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;
}
Configuration requise d’ACX
Version minimale d’ACX : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxelements.h |
| IRQL | PASSIVE_LEVEL |