Fungsi AcxStreamBridgeAddStream (acxstreams.h)

Artikel
10/28/2023

Fungsi AcxStreamBridgeAddStream menambahkan ACXSTREAM yang ada ke ACXSTREAMBRIDGE yang ada. Untuk informasi selengkapnya tentang Objek ACX, lihat ACX - Ringkasan Objek ACX.

Sintaks

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Parameter

Bridge

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

Stream

Objek ACXSTREAM mewakili aliran audio yang dibuat oleh sirkuit. Aliran terdiri dari daftar elemen yang dibuat berdasarkan elemen sirkuit induk.

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

Driver memanggil AcxStreamBridgeAddStream dalam skenario ini:

(a) driver ingin memilih ACXSTREAMBRIDGE secara manual untuk digunakan untuk ACXSTREAM saat ini.

(b) driver (dan persyaratan perangkat kerasnya) memiliki kebutuhan akan ACXCIRCUITs tingkat bawah, yaitu, sirkuit yang lebih dekat ke pin jembatan perangkat, untuk mengambil tindakan sebelum ACXCIRCUITs tingkat atas mengambil tindakan.

Untuk jenis AcxStreamBridgeMux, hanya satu ACXSTREAM downlevel yang dibuat secara independen dari jumlah INPUT ACXSTREAM yang ditambahkan ke jembatan ini. Ini berarti bahwa ACXSTREAM output (yang untuk sirkuit lokal aliran diwakili dengan ACXTARGETSTREAM), hanya dibuat untuk ACXSTREAM pertama yang ditambahkan ke ACXSTREAMBRIDGE. Setiap ACXSTREAM input tambahan, cukup ambil referensi ke ACXTARGETSTREAM yang ada ini.

Untuk jenis AcxSTreamBridgeMux, output ACXTARGETSTREAM dihapus ketika input terakhir ACXSTREAM dihapus dari ACXSTREAMBRIDGE dengan AcxStreamBridgeRemoveStream.

Contoh

Contoh penggunaan ditunjukkan di bawah ini. Kode penanganan kesalahan tidak ditampilkan.

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

        // Pin ID 1 is the bridge pin in this example.
        bridgePin = AcxCircuitGetPinById(Circuit, 1);
        
        status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);

        status = AcxStreamBridgeAddStream(bridge, stream);

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

Share via