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 以外の値は、処理が有効になっていることを示します。 値 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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxelements.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxelements.h ヘッダー