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 d’état est de type ULONG, mais est convertie en type BOOLEAN dans le rappel pour indiquer si le traitement d’effet global 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 de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
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 pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxelements.h |
| IRQL | PASSIVE_LEVEL |