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