Fungsi AcxStreamBridgeCreate (acxstreams.h)

Fungsi AcxStreamBridgeCreate menggunakan ACX_STREAM_BRIDGE_CONFIG untuk membuat StreamBridge untuk sirkuit.

ACXSTREAMBRIDGE digunakan oleh sirkuit untuk menyebarluaskan pembuatan aliran, transisi status aliran, dan pengaturan DRM antara segmen aliran sirkuit titik akhir. Objek ini hanya digunakan dalam skenario multi-sirkuit (komposit audio).

Sintaks

NTSTATUS AcxStreamBridgeCreate(
  ACXCIRCUIT                AcxCircuit,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_STREAM_BRIDGE_CONFIG Config,
  ACXSTREAMBRIDGE           *StreamBridge
);

Parameter

AcxCircuit

Penunjuk ke lokasi yang menerima handel ke Objek ACXCIRCUIT terkait. Untuk informasi selengkapnya tentang Objek ACX, lihat ACX - Ringkasan Objek ACX.

Attributes

Atribut Tambahan yang ditentukan menggunakan WDF_OBJECT_ATTRIBUTES yang digunakan untuk mengatur berbagai nilai objek: membersihkan dan menghancurkan panggilan balik, jenis konteks, dan untuk menentukan objek induknya. Untuk informasi selengkapnya, lihat WDF_OBJECT_ATTRIBUTES struktur dan bagian keterangan dari topik ini.

Config

Struktur ACX_STREAM_BRIDGE_CONFIG yang menentukan konfigurasi.

StreamBridge

Penunjuk ke lokasi yang menerima handel ke Objek ACXSTREAMBRIDGE baru.

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

Titik akhir audio adalah kumpulan satu atau beberapa sirkuit audio (objek ACXCIRCUIT) yang dirakit untuk membuat jalur audio lengkap. Driver ACX biasanya membuat sirkuit audio untuk titik akhir audio yang berbeda, meskipun ACX tidak melarang sirkuit yang dibuat oleh driver yang sama untuk menjadi bagian dari koleksi titik akhir audio yang sama, selama mereka termasuk dalam tumpukan perangkat yang berbeda. Titik akhir audio adalah kumpulan sirkuit audio yang dibuat oleh driver audio yang sama atau berbeda.

Secara default, induk objek ACXSTREAMBRIDGE baru adalah ACXCIRCUIT yang ditentukan. Anda dapat menggunakan anggota ParentObject dari struktur WDF_OBJECT_ATTRIBUTES untuk menentukan induk yang berbeda dengan ACXCIRCUIT sebagai leluhur. Kerangka kerja menghapus objek ACXSTREAMBRIDGE saat menghapus objek induk.

Driver Anda dapat menghapus objek ACXSTREAMBRIDGE setelah selesai menggunakan objek ; jika tidak, objek akan tetap ada sampai induk dihapus, yang merupakan kasus ketika dibuat selama inisialisasi/pembuatan ACXCIRCUIT.

Pin dapat dikaitkan dengan nol, satu atau beberapa ACXSTREAMBRIDGEs. ACX mencari daftar mode pemrosesan sinyal ACXPIN terkait untuk kecocokan mode pemrosesan sinyal aliran. Pencarian berhenti pada kecocokan pertama.

ACX membuat ACXSTREAMBRIDGE default untuk penghubung ACXCIRCUIT ke ACXCIRCUIT jika driver tidak membuatnya, dan driver tidak menonaktifkan penanganan jembatan aliran default dengan fungsi AcxCircuitInitDisableDefaultStreamBridgeHandling.

Contoh

Contoh penggunaan ditunjukkan di bawah ini.

    ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
    ACXSTREAMBRIDGE          bridge = NULL;
    
    ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
    bridgeCfg.InModesCount = 1;
    bridgeCfg.InModes      = inModes; 
    bridgeCfg.OutMode      = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;

    status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);

Persyaratan ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan	Nilai
Header	acxstreams.h
IRQL	PASSIVE_LEVEL

Lihat juga

• header acxstreams.h