Fungsi AcxAudioEngineCreate (acxelements.h)

Artikel
06/02/2025

Fungsi AcxAudioEngineCreate digunakan untuk membuat mesin audio yang akan dikaitkan dengan induk objek perangkat WDFDEVICE sirkuit.

Sintaksis

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.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan mengembalikan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Komentar

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

Syarat	Nilai
Header	acxelements.h
IRQL	PASSIVE_LEVEL

Lihat juga

header acxelements.h

Bagikan melalui