Share via

Fungsi AcxStreamAddConnections (acxstreams.h)

  • Artikel

Fungsi AcxStreamAddConnections menambahkan koneksi eksplisit ke aliran ACX baru selama EvtAcxCircuitCreateStream

Sintaks

NTSTATUS AcxStreamAddConnections(
  ACXSTREAM       Stream,
  PACX_CONNECTION Connections,
  ULONG           ConnectionsCount
);

Parameter

Stream

Objek aliran ACXSTREAM yang ada. Untuk informasi selengkapnya, lihat ACX - Ringkasan Objek ACX.

Connections

Struktur ACX_CONNECTION yang berisi informasi tentang koneksi untuk menambahkan aliran.

ConnectionsCount

Jumlah koneksi yang ada di aliran. Ini adalah jumlah berbasis 1.

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

Jika driver tidak memanggil AcxStreamAddConnections selama EvtAcxCircuitCreateStream, kerangka kerja ACX akan secara otomatis menetapkan koneksi antara objek ACXELEMENT apa pun yang ditambahkan ke ACXSTREAM.

Contoh

Contoh penggunaan ditunjukkan di bawah ini.

    //
    // Explicitly connect the elements of the stream. Note that the driver doesn't 
    // need to perform this step when elements are connected in the same order
    // as they were added to the stream.
    //

    const int numElements = 2;
    const int numConnections = numElements + 1;

    ACXSTREAM                      Stream;

    ACX_CONNECTION connections[numConnections];
    ACX_CONNECTION_INIT(&connections[0], Stream, Elements[ElementCount - 2]);
    ACX_CONNECTION_INIT(&connections[1], Elements[ElementCount - 2], Elements[ElementCount - 1]);
    ACX_CONNECTION_INIT(&connections[2], Elements[ElementCount - 1], Stream);

    //
    // Add the connections linking stream to elements.
    //
    status = AcxStreamAddConnections(Stream, connections, SIZEOF_ARRAY(connections));

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