Fungsi HwNRegisterClient (hwnclx.h)

Mendaftarkan driver klien pemberitahuan perangkat keras dan fungsi panggilan baliknya dengan ekstensi kelas. Fungsi ini harus dipanggil ketika driver klien dimuat dan rutinitas DriverEntry dipanggil untuk inisialisasi.

Sintaks

FORCEINLINE NTSTATUS  HwNRegisterClient(
  _In_    WDFDRIVER                        Driver,
  _Inout_ PHWN_CLIENT_REGISTRATION_PACKET  RegistrationPacket,
  _In_    PUNICODE_STRING                  RegistryPath
);

Parameter

[in] Driver

Tangani ke objek driver kerangka kerja driver klien.

[in, out] RegistrationPacket

Arahkan ke struktur HWN_CLIENT_REGISTRATION_PACKET yang berisi penunjuk fungsi ke fungsi panggilan balik yang ditentukan dalam implementasi driver klien dan diperlukan oleh ekstensi kelas.

[in] RegistryPath

Penunjuk ke struktur UNICODE_STRING yang berisi jalur ke kunci registri driver klien.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika fungsi berhasil. Mengembalikan STATUS_INVALID_PARAMETER jika driver klien yang sesuai tidak dapat ditemukan. Jika tidak, ia mengembalikan salah satu nilai status kesalahan yang ditentukan dalam Ntstatus.h.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1709
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Header hwnclx.h
Pustaka Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

Lihat juga

Dukungan pemberitahuan perangkat keras

Referensi pemberitahuan perangkat keras