PROTOCOL_CL_INCOMING_DROP_PARTY fungsi panggilan balik (ndis.h)

Artikel
02/26/2024

Fungsi ProtocolClIncomingDropParty digunakan oleh klien NDIS berorientasi koneksi yang menyiapkan koneksi multipoint. Klien tersebut harus memiliki fungsi ProtocolClIncomingDropParty . Jika tidak, fungsi ProtocolClIncomingDropParty yang terdaftar dari driver protokol seperti itu hanya dapat mengembalikan kontrol.

Catatan Anda harus mendeklarasikan fungsi dengan menggunakan jenis PROTOCOL_CL_INCOMING_DROP_PARTY . Untuk informasi selengkapnya, lihat bagian Contoh berikut ini.

Sintaks

PROTOCOL_CL_INCOMING_DROP_PARTY ProtocolClIncomingDropParty;

void ProtocolClIncomingDropParty(
  [in] NDIS_STATUS DropStatus,
  [in] NDIS_HANDLE ProtocolPartyContext,
  [in] PVOID CloseData,
  [in] UINT Size
)
{...}

Parameter

[in] DropStatus

Menunjukkan alasan pesta dihilangkan. Biasanya, ini NDIS_STATUS_SUCCESS jika pihak pada catatan jarak jauh memulai penutupan koneksinya, tetapi bisa jadi status yang ditentukan CM jika manajer panggilan memulai operasi drop-party ini karena masalah jaringan yang ditemukannya.

[in] ProtocolPartyContext

Menentukan handel ke area konteks per pihak klien agar pihak tersebut dihilangkan. Klien awalnya menyediakan handel ini ke NDIS ketika disebut NdisClAddParty atau NdisClMakeCall.

[in] CloseData

Penunjuk ke buffer yang berisi pesan tutup khusus protokol, mungkin satu disediakan oleh klien jarak jauh yang diterima manajer panggilan melalui jaringan, atau parameter ini bisa NULL.

Ketika DropStatus NDIS_STATUS_SUCCESS, parameter ini adalah NULL jika media jaringan yang mendasar tidak mendukung transfer data saat menutup koneksi. Namun, setiap manajer panggilan tertentu mungkin menentukan struktur untuk meneruskan informasi diagnostik tambahan kepada kliennya pada operasi drop-party yang disebabkan oleh masalah pada jaringan.

[in] Size

Menentukan panjang, dalam byte, dari buffer di CloseData, nol jika CloseData adalah NULL.

Mengembalikan nilai

Tidak ada

Keterangan

Panggilan ke ProtocolClIncomingDropParty menunjukkan bahwa salah satu hal berikut ini telah terjadi:

Manajer panggilan telah menerima permintaan melalui jaringan untuk menutup koneksi yang dibuat, yang diidentifikasi oleh NdisPartyHandle bahwa klien disimpan di area konteks per pihaknya di ProtocolPartyContext .
Manajer panggilan telah mendeteksi bahwa masalah jaringan akan mencegah transfer data lebih lanjut pada koneksi yang dibuat.

Dalam kedua kasus, ProtocolClIncomingDropParty harus melakukan operasi yang ditentukan protokol untuk menghilangkan pihak dari VC multipoint klien. ProtocolClIncomingDropParty harus memanggil NdisClDropParty atau, jika ini adalah pihak terakhir yang tersisa di VC multipoint klien, NdisClCloseCall.

ProtocolClIncomingDropParty harus mempertimbangkan NdisPartyHandle yang diperoleh klien dari NdisClAddParty atau NdisClMakeCall tidak valid. ProtocolClIncomingDropParty dapat merilis area konteks per pihak klien atau menyiapkannya untuk digunakan kembali dalam panggilan berikutnya ke NdisClAddParty.

Contoh

Untuk menentukan fungsi ProtocolClIncomingDropParty , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis fungsi yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan fungsi ProtocolClIncomingDropParty yang diberi nama "MyClIncomingDropParty", gunakan jenis PROTOCOL_CL_INCOMING_DROP_PARTY seperti yang ditunjukkan dalam contoh kode ini:

PROTOCOL_CL_INCOMING_DROP_PARTY MyClIncomingDropParty;

Kemudian, terapkan fungsi Anda sebagai berikut:

_Use_decl_annotations_
VOID
 MyClIncomingDropParty(
    NDIS_STATUS  DropStatus,
    NDIS_HANDLE  ProtocolPartyContext,
    PVOID  CloseData,
    UINT  Size
    )
  {...}

Jenis fungsi PROTOCOL_CL_INCOMING_DROP_PARTY didefinisikan dalam file header Ndis.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi Use_decl_annotations ke definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi PROTOCOL_CL_INCOMING_DROP_PARTY dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver NDIS.

Untuk informasi tentang Use_decl_annotations, lihat Perilaku Fungsi Anotasi.

Persyaratan

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