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