Fungsi NmrDeregisterProvider (netioddk.h)

Artikel
02/29/2024

Fungsi NmrDeregisterProvider membatalkan pendaftaran modul penyedia dari NMR.

Sintaks

NTSTATUS NmrDeregisterProvider(
  [in] HANDLE NmrProviderHandle
);

Parameter

[in] NmrProviderHandle

Handel yang digunakan oleh NMR untuk mewakili pendaftaran modul penyedia. NMR mengembalikan handel ini ke modul penyedia saat modul penyedia memanggil fungsi NmrRegisterProvider .

Nilai kembali

Fungsi NmrDeregisterProvider mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_PENDING	NMR memulai deregistrasi modul penyedia. Modul penyedia harus memanggil Fungsi NmrWaitForProviderDeregisterComplete untuk menunggu hingga deregistrasi selesai sebelum modul penyedia dapat dibongkar.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Saat modul penyedia memanggil fungsi NmrDeregisterProvider , NMR memanggil fungsi panggilan balik ProviderDetachClient modul penyedia dan fungsi panggilan balik ClientDetachProvider modul klien untuk setiap pengikatan antara modul penyedia dan modul klien. Deregistrasi modul penyedia dari NMR selesai setelah modul penyedia berhasil melepaskan dari semua modul klien tempat modul dilampirkan dan semua modul klien tersebut telah berhasil dilepas dari modul penyedia.

Modul penyedia biasanya memanggil fungsi NmrDeregisterProvider dari fungsi Unload-nya untuk melepaskan dirinya dari semua modul klien yang dilampirkan sebelum modul penyedia dibongkar dari sistem. Setelah memanggil fungsi NmrDeregisterProvider , modul penyedia harus memanggil Fungsi NmrWaitForProviderDeregisterComplete menunggu deregistrasi selesai sebelum modul penyedia dapat dibongkar. Modul penyedia tidak boleh kembali dari panggilan ke fungsi Unload-nya sampai setelah deregistrasi selesai.

Catatan Jika modul penyedia menggunakan Windows Driver Framework, modul biasanya akan memanggil Fungsi NmrDeregisterProvider dari fungsi panggilan balik peristiwa EvtDriverUnload . Dalam situasi ini, modul penyedia tidak boleh kembali dari panggilan ke fungsi EvtDriverUnload hingga setelah deregistrasi selesai.

Persyaratan

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