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 global des effets 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 qu’une valeur de 0 indique que le traitement global des effets dans le nœud du moteur audio 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 _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 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 |