次の方法で共有

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 バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxelements.h
IRQL PASSIVE_LEVEL

関連項目