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 |