Fungsi NdisCmDispatchIncomingDropParty (ndis.h)

  • Artikel

NdisCmDispatchIncomingDropParty memberi tahu klien bahwa klien harus menghapus pihak tertentu pada VC multipoint, biasanya karena manajer panggilan telah menerima permintaan melalui jaringan untuk menutup koneksi multipoint aktif.

Sintaks

void NdisCmDispatchIncomingDropParty(
  [in]           NDIS_STATUS DropStatus,
  [in]           NDIS_HANDLE NdisPartyHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

Parameter

[in] DropStatus

Menunjukkan alasan pihak ini dihilangkan, biasanya NDIS_STATUS_SUCCESS jika pihak jarak jauh hanya meminta agar koneksinya ditutup.

[in] NdisPartyHandle

Menentukan handel yang mengidentifikasi pihak yang akan dihilangkan dari VC multipoint, yang harus memiliki pihak lain yang masih terhubung.

[in, optional] Buffer

Pointer ke buffer residen yang dialokasikan penelepon yang berisi data khusus protokol tambahan yang diterima dari pihak jarak jauh, jika ada. Tergantung pada media yang mendasar, pointer ini bisa NULL.

[in] Size

Menentukan ukuran dalam byte buffer, nol jika Bufferadalah NULL.

Nilai kembali

Tidak ada

Keterangan

Dalam operasi jaringan normal, manajer panggilan yang berdiri sendiri Fungsi ProtocolCoReceiveNetBufferLists memanggil NdisCmDispatchIncomingDropParty dengan CloseStatus diatur ke NDIS_STATUS_SUCCESS karena klien jarak jauh pada koneksi multipoint telah disebut NdisClCloseCall.

Namun, manajer panggilan juga dapat memanggil NdisCmDispatchIncomingDropParty dengan CloseStatus yang ditentukan CM atas perintah jaringan itu sendiri jika kondisi jaringan abnormal terjadi, seperti kegagalan sakelar pada jalur antara klien lokal dan satu atau beberapa klien pada koneksi multipoint yang dibuat.

Panggilan ke NdisCmDispatchIncomingDropParty menyebabkan NDIS memanggil klien Fungsi ProtocolClIncomingDropParty .

Jika NdisPartyHandle mengidentifikasi pihak terakhir yang tersisa pada VC yang diberikan, CM akan memanggil NdisCmDispatchIncomingCloseCall, bukan NdisCmDispatchIncomingDropParty.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisCmDispatchIncomingDropParty (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisCmDispatchIncomingDropParty (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)

Lihat juga

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists