Fungsi AcxAudioEngineCreate (acxelements.h)
Fungsi AcxAudioEngineCreate digunakan untuk membuat mesin audio yang akan dikaitkan dengan induk objek perangkat WDFDEVICE sirkuit.
Sintaks
NTSTATUS AcxAudioEngineCreate(
ACXCIRCUIT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOENGINE_CONFIG Config,
ACXAUDIOENGINE *AudioEngine
);
Parameter
Object
Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang akan dikaitkan dengan sirkuit.
Attributes
Struktur WDF_OBJECT_ATTRIBUTES yang digunakan untuk mengaitkan AcxAudioEngine dengan objek sirkuit induk. Perhatikan bahwa atribut WDF tambahan seperti WDF_EXECUTION_LEVEL atau WDF_SYNCHRONIZATION_SCOPE, tidak boleh diatur menggunakan parameter Atribut karena dikelola oleh ACX.
Config
Struktur ACX_AUDIOENGINE_CONFIG yang diinisialisasi yang menjelaskan konfigurasi mesin audio.
AudioEngine
Penunjuk ke lokasi yang menerima handel ke objek ACXAUDIOENGINE baru yang digunakan dalam sirkuit render, untuk mewakili DSP. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.
Menampilkan nilai
Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.
Keterangan
Contoh
Contoh penggunaan ditunjukkan di bawah ini.
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);
Persyaratan ACX
Versi ACX minimum: 1.0
Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |