Makro NdisMCmAddPartyComplete (ndis.h)

Artikel
08/07/2023

NdisMCmAddPartyComplete mengembalikan status akhir permintaan klien, yang sebelumnya dikembalikan driver MCM NDIS_STATUS_PENDING, untuk menambahkan pihak pada VC multipoint yang ditetapkan.

Sintaks

void NdisMCmAddPartyComplete(
   _S_,
   _H_,
   _C_,
   _P_
);

Parameter

_S_

Menentukan status akhir operasi add-party driver MCM, baik NDIS_STATUS_SUCCESS atau NDIS_STATUS_XXXkecuali NDIS_STATUS_PENDING.

_H_

Menentukan handel yang mengidentifikasi pihak. Driver MCM memperoleh handel ini sebagai parameter input ke fungsi ProtocolCmAddParty-nya .

_C_

Menentukan handel ke area konteks penduduk yang dialokasikan penelepon di mana driver MCM akan mempertahankan informasi status khusus pihak jika operasi add-party berhasil. Jika tidak, parameter ini bisa NULL karena diabaikan oleh NDIS jika Status adalah apa pun selain NDIS_STATUS_SUCCESS.

_P_

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

Nilai kembali

Tidak ada

Keterangan

Jika fungsi ProtocolCmAddParty driver MCM mengembalikan NDIS_STATUS_PENDING, driver harus memanggil NdisMCmAddPartyComplete kemudian untuk memberi tahu klien dan NDIS bahwa upayanya untuk menambahkan pihak pada VC multipoint telah selesai, baik berhasil atau dengan status kesalahan yang ditentukan driver MCM.

Media jaringan yang mendasar menentukan apakah klien dapat menentukan parameter lalu lintas per pihak pada VC multipoint.

Jika media jaringan yang mendasar tidak mendukung parameter lalu lintas per pihak pada VC multipoint, driver MCM dapat melakukan salah satu hal berikut setiap kali klien mencoba menambahkan pihak dengan spesifikasi di CallParameters yang tidak cocok dengan parameter lalu lintas yang sudah ditetapkan untuk VC tersebut:

Reset parameter lalu lintas ke yang sudah ditetapkan untuk VC multipoint ketika berhasil menambahkan pihak pada VC tersebut.
Ubah parameter lalu lintas untuk setiap pihak yang sudah ada di VC ketika berhasil menambahkan pihak baru.
Tolak permintaan untuk menambahkan pihak baru. (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.)

Jika driver MCM mengatur Status ke NDIS_STATUS_SUCCESS, driver harus menyediakan handel eksplisit, yang biasanya merupakan pointer ke area status per pihak yang dialokasikan driver, sebagai CallMgrPartyContext saat memanggil NdisMCmAddPartyComplete.

Panggilan ke NdisMCmAddPartyComplete menyebabkan NDIS memanggil klien Fungsi ProtocolClAddPartyComplete .

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

Persyaratan

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