AcxAudioEngineCreate 関数 (acxelements.h)

AcxAudioEngineCreate 関数は、回路 WDFDEVICE デバイス オブジェクトの親に関連付けられるオーディオ エンジンを作成するために使用されます。

構文

NTSTATUS AcxAudioEngineCreate(
  ACXCIRCUIT              Object,
  PWDF_OBJECT_ATTRIBUTES  Attributes,
  PACX_AUDIOENGINE_CONFIG Config,
  ACXAUDIOENGINE          *AudioEngine
);

パラメーター

Object

回線に関連付けられる WDFDEVICE オブジェクト ( フレームワーク オブジェクトの概要に関するページで説明)。

Attributes

AcxAudioEngine を親回線オブジェクトに関連付けるために使用される WDF_OBJECT_ATTRIBUTES 構造体。 WDF_EXECUTION_LEVELやWDF_SYNCHRONIZATION_SCOPEなどの追加の WDF 属性は、ACX によって管理されるため、 Attributes パラメーターを使用して設定しないでください。

Config

オーディオ エンジンの構成を記述する初期化された ACX_AUDIOENGINE_CONFIG構造体 。

AudioEngine

DSP を表すためにレンダリング回路で使用される新しい ACXAUDIOENGINE オブジェクトへのハンドルを受け取る場所へのポインター。 ACX オブジェクトの詳細については、「 ACX オブジェクトの概要」を参照してください。

戻り値

STATUS_SUCCESS呼び出しが成功した場合は を返します。 それ以外の場合は、適切なエラー コードを返します。 詳細については、「 NTSTATUS 値の使用」を参照してください。

解説

例

使用例を次に示します。

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACX_AUDIOENGINE_CONFIG          audioEngineCfg;

    ACX_AUDIOENGINE_CONFIG_INIT(&audioEngineCfg);

    audioEngineCfg.HostPin = Pins[HostPin];
    audioEngineCfg.OffloadPin = Pins[OffloadPin];
    audioEngineCfg.LoopbackPin = Pins[LoopbackPin];
    audioEngineCfg.VolumeElement = volumeElement;
    audioEngineCfg.MuteElement = muteElement;
    audioEngineCfg.PeakMeterElement = peakmeterElement;
    audioEngineCfg.Callbacks = &audioEngineCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ENGINE_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxAudioEngineCreate(Circuit, &attributes, &audioEngineCfg, AudioEngine);

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。

要件

要件	値
Header	acxelements.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxelements.h ヘッダー