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

另請參閱

• acxelements.h 標頭