функция обратного вызова EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE (acxelements.h)
Функция обратного вызова EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE реализуется драйвером и вызывается при запросе состояния глобальных эффектов для указанного узла обработчика звука.
Синтаксис
EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;
NTSTATUS EvtAcxAudioengineRetrieveEffectsState(
ACXAUDIOENGINE AudioEngine,
PULONG State
)
{...}
Параметры
AudioEngine
Объект ACXAUDIOENGINE, для которого запрошено состояние глобальных эффектов. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.
State
Значение ULONG, указывающее состояние глобальных эффектов указанного узла обработчика звука. Ненулевое значение указывает, что включена обработка глобальных эффектов в узле обработчика звука, а значение 0 указывает на то, что обработка глобальных эффектов в узле обработчика звука отключена.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Remarks
Пример
Ниже приведен пример использования.
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;
}
Требования к ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxelements.h |
| IRQL | PASSIVE_LEVEL |