Share via

Fungsi AcxStreamBridgeRemoveStream (acxstreams.h)

  • Artikel

Fungsi AcxStreamBridgeRemoveStream menghapus ACXSTREAM yang ditentukan dari objek ACXSTREAMBRIDGE . Untuk informasi selengkapnya tentang Objek ACX, lihat ACX - Ringkasan Objek ACX.

Sintaks

NTSTATUS AcxStreamBridgeRemoveStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Parameter

Bridge

Objek 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).

Stream

Handel ke Objek ACXSTREAM yang akan dihapus dari ACXSTREAMBRIDGE.

Menampilkan nilai

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

Keterangan

DDI ini hanya dapat dipanggil dari konteks handler pembersihan aliran driver. Pemanggil memanggil DDI ini untuk memisahkan ACXSTREAM input secara manual dari objek ACXSTREAMBRIDGE yang ditentukan.

Driver memanggil AcxStreamBridgeRemoveStream dalam skenario ini:

(a) driver ingin menghapus ACXSTREAM secara manual dari ACXSTREAMBRIDGE.

(b) driver (dan persyaratan h/w mereka) membutuhkan ACXSTREAMs tingkat atas yaitu, aliran sirkuit lebih dekat ke pin jembatan streaming, untuk mengambil tindakan sebelum ACXSTREAMs downlevel.

(c) driver perlu mengambil tindakan sebelum dan sesudah ACXSTREAM downlevel hilang.

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 INPUT TAMBAHAN ACXSTREAMs hanya mengambil 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.

    status = AcxStreamBridgeAddStream(bridge, stream);

    // Get I/O target to send I/O to the target stream.
    targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
 
    // Target stream is closed if this was last input ACXSTREAM removed.
    status = AcxStreamBridgeRemoveStream(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