次の方法で共有

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 以外の値は、オーディオ エンジン ノードでのグローバル効果処理が有効であることを示し、値 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

関連項目