EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE funzione di callback (acxelements.h)
La funzione di callback EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE viene implementata dal driver e viene chiamata quando viene richiesto lo stato degli effetti globali per il nodo del motore audio specificato.
Sintassi
EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;
NTSTATUS EvtAcxAudioengineRetrieveEffectsState(
ACXAUDIOENGINE AudioEngine,
PULONG State
)
{...}
Parametri
AudioEngine
Oggetto ACXAUDIOENGINE per il quale è stato richiesto lo stato degli effetti globali. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
State
Valore ULONG che indica lo stato degli effetti globali del nodo del motore audio specificato. Un valore diverso da zero indica che l'elaborazione dell'effetto globale nel nodo del motore audio è abilitata e il valore 0 indica che l'elaborazione dell'effetto globale nel nodo del motore audio è disabilitata.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.
Osservazioni
Esempio
Di seguito è riportato un esempio di utilizzo.
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;
}
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |