функция обратного вызова EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE (acxelements.h)
Функция обратного вызова EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE реализуется драйвером и вызывается при запросе состояния локальных эффектов для указанного звукового модуля потока.
Синтаксис
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxStreamaudioengineRetrieveEffectsState;
NTSTATUS EvtAcxStreamaudioengineRetrieveEffectsState(
ACXSTREAMAUDIOENGINE StreamAudioEngine,
PULONG State
)
{...}
Параметры
StreamAudioEngine
Существующий, инициализированный объект ACXSTREAMAUDIOENGINE. Дополнительные сведения о объектах ACX см. в сводке по объектам ACX.
State
Значение ULONG, указывающее, включена ли локальная обработка эффектов в узле подсистемы аудиопотока. Значение, отличное от нуля, указывает, что обработка включена. Значение 0 указывает, что он отключен.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.
Замечания
Пример
Ниже показан пример использования.
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE DspR_EvtAcxStreamAudioEngineRetrieveEffectsState;
NTSTATUS
DspR_EvtAcxStreamAudioEngineRetrieveEffectsState(
ACXSTREAMAUDIOENGINE StreamAudioEngine,
PULONG State
)
{
PAGED_CODE();
PDSP_STREAMAUDIOENGINE_CONTEXT pStreamAudioEngineCtx;
pStreamAudioEngineCtx = GetDspStreamAudioEngineContext(StreamAudioEngine);
*State = pStreamAudioEngineCtx->LFxEnabled;
return STATUS_SUCCESS;
}
Требования к ACX
минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в обзоре версий ACX.
Требования
| Требование | Ценность |
|---|---|
| заголовка | acxelements.h |
| IRQL | PASSIVE_LEVEL |