Fungsi NmrRegisterClient (netioddk.h)
Fungsi NmrRegisterClient mendaftarkan modul klien dengan NMR.
Sintaks
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Parameter
[in] ClientCharacteristics
Penunjuk ke NPI_CLIENT_CHARACTERISTICS struktur yang menjelaskan karakteristik modul klien. Modul klien harus memastikan bahwa struktur ini tetap valid dan tinggal dalam memori selama modul klien terdaftar di NMR.
[in] ClientContext
Penunjuk ke konteks yang disediakan penelepon untuk pendaftaran. Modul klien menggunakan konteks ini untuk melacak status pendaftaran klien. Konten konteks pendaftaran modul klien buram ke NMR. NMR meneruskan pointer ini ke modul klien setiap kali memanggil fungsi panggilan balik ClientAttachProvider modul klien. Modul klien harus memastikan bahwa konteks pendaftarannya tetap valid dan tinggal dalam memori selama modul klien terdaftar di NMR.
[out] NmrClientHandle
Pointer ke variabel yang menerima handel yang digunakan oleh NMR untuk mewakili pendaftaran modul klien. Modul klien harus menyimpan handel ini dan meneruskannya sebagai parameter ke fungsi NmrDeregisterClient saat membatalkan pendaftaran dari NMR.
Nilai kembali
Fungsi NmrRegisterClient mengembalikan salah satu kode NTSTATUS berikut:
Menampilkan kode | Deskripsi |
---|---|
|
NMR berhasil mendaftarkan modul klien. |
|
NMR tidak memiliki sumber daya sistem yang memadai untuk mendaftarkan modul klien. |
|
Terjadi kesalahan. |
Keterangan
Modul klien memanggil fungsi NmrRegisterClient untuk mendaftar sebagai klien NPI sehingga dapat melampirkan ke modul penyedia yang mendaftar sebagai penyedia NPI yang sama.
Modul klien biasanya memanggil fungsi NmrRegisterClient dari fungsi DriverEntry-nya setelah menyelesaikan semua tugas inisialisasi lainnya. Panggilan ke fungsi NmrRegisterClient menunjukkan kepada NMR bahwa modul klien siap untuk dilampirkan ke modul penyedia apa pun yang telah mendaftar atau akan mendaftar sebagai penyedia NPI yang sama yang modul kliennya telah terdaftar sebagai klien.
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 | PASSIVE_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk