Partager via


EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE fonction de rappel (acxelements.h)

La fonction de rappel EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE est implémentée par le pilote et est appelée lorsque l’état des effets globaux est demandé pour le nœud du moteur audio spécifié.

Syntaxe

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;

NTSTATUS EvtAcxAudioengineRetrieveEffectsState(
  ACXAUDIOENGINE AudioEngine,
  PULONG State
)
{...}

Paramètres

AudioEngine

Objet ACXAUDIOENGINE pour lequel l’état des effets globaux a été demandé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

State

Valeur ULONG indiquant l’état des effets globaux du nœud du moteur audio spécifié. Une valeur différente de zéro indique que le traitement global des effets dans le nœud du moteur audio est activé et la valeur 0 indique que le traitement global des effets dans le nœud du moteur audio est désactivé.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle 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 _CODEC_ENGINE_CONTEXT {
    ACXDATAFORMAT   MixFormat;
    BOOLEAN         GFxEnabled;
} CODEC_ENGINE_CONTEXT, *PCODEC_ENGINE_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_ENGINE_CONTEXT, GetCodecEngineContext)

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE      Codec_EvtAcxAudioEngineRetrieveEffectsState;

NTSTATUS
Codec_EvtAcxAudioEngineRetrieveEffectsState(
    _In_    ACXAUDIOENGINE  AudioEngine,
    _Out_   PULONG          State
)
{
    PAGED_CODE();

    PCODEC_ENGINE_CONTEXT   pAudioEngineCtx;
    pAudioEngineCtx = GetCodecEngineContext(AudioEngine);

    *State = pAudioEngineCtx->GFxEnabled;

    return STATUS_SUCCESS;
}

Configuration requise pour ACX

Version ACX minimale : 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

Voir aussi