Makro NdisMCmDispatchIncomingDropParty (ndis.h)

NdisMCmDispatchIncomingDropParty memberi tahu klien bahwa ia harus menghapus pihak tertentu pada VC multipoint.

Sintaks

void NdisMCmDispatchIncomingDropParty(
   _S_,
   _H_,
   _B_,
   _Z_
);

Parameter

_S_

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

_H_

Menentukan handel yang mengidentifikasi pihak yang akan dihilangkan dari VC multipoint, yang harus memiliki pihak lain yang masih terhubung. Driver MCM awalnya memperoleh handel ini sebagai parameter input untuk fungsi ProtocolCmAddParty-nya .

_B_

Arahkan 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.

_Z_

Menentukan ukuran dalam byte buffer, nol jika BufferNULL.

Nilai kembali

Tidak ada

Keterangan

Dalam operasi jaringan normal, driver MCM memanggil NdisMCmDispatchIncomingDropParty dengan CloseStatus diatur ke NDIS_STATUS_SUCCESS karena klien jarak jauh pada koneksi multipoint telah disebut NdisClCloseCall.

Namun, driver MCM juga dapat memanggil NdisMCmDispatchIncomingDropParty dengan CloseStatus yang ditentukan driver atas permintaan 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 NdisMCmDispatchIncomingDropParty menyebabkan NDIS memanggil klien Fungsi ProtocolClIncomingDropParty .

Jika NdisPartyHandle mengidentifikasi pihak terakhir yang tersisa pada VC yang diberikan, driver MCM akan memanggil NdisMCmDispatchIncomingCloseCall, bukan NdisMCmDispatchIncomingDropParty.

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

Persyaratan

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

Lihat juga

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty