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值。
備註
範例
範例使用方式如下所示。
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 |