Fungsi NdisCmAddPartyComplete (ndis.h)

Artikel
08/07/2023

NdisCmAddPartyComplete mengembalikan status akhir permintaan klien, yang sebelumnya dikembalikan manajer panggilan NDIS_STATUS_PENDING, untuk menambahkan pihak pada VC multipoint yang ditetapkan.

Sintaks

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] Status

Menentukan status akhir operasi add-party manajer panggilan, baik NDIS_STATUS_SUCCESS atau NDIS_STATUS_XXX kecuali NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Menentukan handel yang mengidentifikasi pihak. Handel ini dimasukkan ke fungsi ProtocolCmAddParty manajer panggilan.

[in, optional] CallMgrPartyContext

Menentukan handel ke area konteks penduduk yang dialokasikan pemanggil di mana manajer panggilan akan mempertahankan informasi status khusus pihak jika operasi add-party berhasil. Jika tidak, parameter ini bisa NULL karena diabaikan.

[in] CallParameters

Pointer ke struktur jenis CO_CALL_PARAMETERS yang berisi parameter panggilan, awalnya disediakan oleh klien, agar pihak ditambahkan.

Nilai kembali

Tidak ada

Keterangan

Jika fungsi ProtocolCmAddParty manajer panggilan yang berdiri sendiri mengembalikan NDIS_STATUS_PENDING, CM kemudian harus memanggil NdisCmAddPartyComplete untuk memberi tahu klien dan NDIS bahwa upayanya untuk menambahkan pihak pada VC multipoint telah selesai, baik berhasil atau dengan kesalahan.

Jika klien meneruskan parameter lalu lintas di CallParameters yang tidak cocok dengan yang sudah ditetapkan untuk VC multipoint, perancang manajer panggilan harus menentukan cara menangani kondisi ini, tunduk pada batasan apa pun yang diberlakukan oleh media jaringan. Kemungkinannya meliputi hal-hal berikut:

Siapkan parameter lalu lintas per pihak jika media jaringan yang mendasar mendukung fitur ini pada VC multipoint.
Reset parameter lalu lintas yang disediakan klien ke yang ditetapkan untuk VC ketika panggilan keluar asli dilakukan sebelum CM memanggil NdisCmAddPartyComplete dengan NDIS_STATUS_SUCCESS sebagai Status .
Ubah parameter lalu lintas untuk VC dan, untuk setiap pihak yang saat ini terhubung di dalamnya, ke nilai yang disediakan klien sebelum CM memanggil NdisCmAddPartyComplete dengan NDIS_STATUS_SUCCESS sebagai Status .
Gagalkan upaya klien untuk menambahkan pihak. (Alternatif ini secara implisit memaksa klien untuk menyiapkan parameter lalu lintas mereka untuk VC multipoint dengan NdisClMakeCall dan untuk menentukan parameter lalu lintas yang sama pada setiap panggilan berikutnya ke NdisClAddParty untuk VC multipoint yang diberikan.)

Untuk beberapa media berorientasi koneksi, parameter lalu lintas bersifat per-VC dan, akibatnya, identik untuk semua pihak pada VC multipoint.

Jika CM mengatur Status ke NDIS_STATUS_SUCCESS, CM harus menyediakan handel eksplisit, yang biasanya merupakan penunjuk ke area status per pihak yang dialokasikan CM, sebagai CallMgrPartyContext saat memanggil NdisCmAddPartyComplete.

Panggilan ke NdisCmAddPartyComplete menyebabkan NDIS memanggil klien Fungsi ProtocolClAddPartyComplete .

Hanya manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, yang dapat memanggil NdisCmAddPartyComplete. Driver miniport berorientasi koneksi yang menyediakan panggilan dukungan manajemen panggilan terintegrasi NdisMCmAddPartyComplete sebagai gantinya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisCmAddPartyComplete (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisCmAddPartyComplete (NDIS 5.1)) di Windows XP.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_CallManager_Function(ndis)