NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN fungsi panggilan balik (netioddk.h)

Artikel
02/29/2024

Fungsi panggilan balik ClientCleanupBindingContext modul klien melakukan pembersihan dan dealokasi konteks pengikatan modul klien yang diperlukan setelah modul klien dan modul penyedia telah terlepas satu sama lain.

Sintaks

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [in] PVOID ClientBindingContext
)
{...}

Parameter

[in] ClientBindingContext

Penunjuk ke konteks modul klien untuk pengikatan antara modul klien dan modul penyedia tempat modul dilepaskan. Modul klien meneruskan pointer ini ke NMR saat memanggil fungsi NmrClientAttachProvider untuk dilampirkan ke modul penyedia.

Nilai kembali

Tidak ada

Keterangan

NMR memanggil fungsi panggilan balik ClientCleanupBindingContext modul klien setelah modul klien dan modul penyedia telah terlepas satu sama lain.

Fungsi panggilan balik ClientCleanupBindingContext modul klien harus melakukan pembersihan data yang diperlukan yang terkandung dalam struktur konteks pengikatan modul klien. Kemudian harus membebaskan memori untuk struktur konteks pengikatan jika modul klien secara dinamis mengalokasikan memori untuk struktur.

Jika modul klien tidak secara dinamis mengalokasikan memori untuk konteks pengikatannya dan tidak diperlukan pembersihan konteks pengikatan lainnya, modul klien tidak perlu menerapkan fungsi panggilan balik ClientCleanupBindingContext . Jika modul klien tidak mengimplementasikan fungsi panggilan balik ClientCleanupBindingContext , maka modul klien harus mengatur anggota ClientCleanupBindingContext dari NPI_CLIENT_CHARACTERISTICS struktur ke NULL ketika memanggil fungsi NmrRegisterClient untuk mendaftarkan dirinya dengan NMR.

NMR memanggil fungsi panggilan balik ClientCleanupBindingContext modul klien di IRQL <= DISPATCH_LEVEL apa pun.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Windows
Header	netioddk.h (termasuk Wsk.h)
IRQL	<= DISPATCH_LEVEL