Pemberitahuan Perangkat Keras

Windows menyediakan infrastruktur untuk dukungan perangkat keras-agnostik komponen pemberitahuan seperti LED dan mekanisme getaran. Dukungan ini disampaikan melalui pengenalan ekstensi kelas Kernel-Mode Driver Framework (KMDF) khusus untuk komponen pemberitahuan perangkat keras yang memungkinkan pengembangan driver klien yang cepat. Ekstensi kelas KMDF pada dasarnya adalah driver KMDF yang menyediakan serangkaian fungsionalitas yang ditentukan untuk kelas perangkat tertentu, mirip dengan driver port di Windows Driver Model (WDM). Bagian ini memberikan gambaran umum tentang arsitektur ekstensi kelas pemberitahuan perangkat keras.

Untuk informasi tambahan tentang KMDF, lihat Menggunakan WDF untuk Mengembangkan Driver.

Untuk memberikan dukungan untuk pemberitahuan perangkat keras, Anda memerlukan:

• hwnclx.h

Enumerasi

HWN_CLX_EXPORT_INDEX Menentukan posisi untuk setiap ekspor Pemberitahuan Perangkat Keras dalam tabel ekspor.

Fungsi

HWN_CLIENT_GET_STATE Diimplementasikan oleh driver klien untuk mendapatkan status komponen pemberitahuan perangkat keras. Ini dipanggil ketika pengguna meminta informasi status.
HWN_CLIENT_INITIALIZE_DEVICE Diimplementasikan oleh driver klien dan dipanggil sebagai akibat dari panggilan ke EVT_WDF_DEVICE_PREPARE_HARDWARE.
HWN_CLIENT_QUERY_DEVICE_INFORMATION Diimplementasikan oleh driver klien untuk mengambil atribut komponen pemberitahuan perangkat keras.
HWN_CLIENT_SET_STATE Diimplementasikan oleh driver klien untuk mengatur status komponen pemberitahuan perangkat keras. Ini dipanggil ketika pengguna ingin mengubah status driver.
HWN_CLIENT_START_DEVICE Diimplementasikan oleh driver klien untuk memulai komponen pemberitahuan perangkat keras. Ini dipanggil sebagai akibat dari panggilan ke EVT_WDF_DEVICE_D0_ENTRY.
HWN_CLIENT_STOP_DEVICE Diimplementasikan oleh driver klien UNTUK memulai komponen pemberitahuan perangkat keras. Ini dipanggil sebagai akibat dari panggilan ke EVT_WDF_DEVICE_D0_EXIT.
HWN_CLIENT_UNINITIALIZE_DEVICE Diimplementasikan oleh driver klien dan dipanggil sebagai dipanggil sebagai akibat dari panggilan ke EVT_WDF_DEVICE_RELEASE_HARDWARE. Fungsi panggilan balik ini membatalkan inisialisasi komponen pemberitahuan perangkat keras.
HwNProcessAddDevicePostDeviceCreate Membuat antrean I/O. Ini harus dipanggil setelah fungsi panggilan balik EVT_WDF_DRIVER_DEVICE_ADD driver klien dipanggil dan objek perangkat telah dibuat.
HwNProcessAddDevicePreDeviceCreate Menyediakan panggilan balik persiapan/rilis dan masuk/keluar perangkat ke Windows Driver Foundation (WDF) untuk transisi perangkat ke berbagai status.
HwNRegisterClient Mendaftarkan driver klien pemberitahuan perangkat keras dan fungsi panggilan baliknya dengan ekstensi kelas.
HwNUnregisterClient Membatalkan pendaftaran driver klien pemberitahuan perangkat keras dan fungsi panggilan baliknya dengan ekstensi kelas. Fungsi ini harus dipanggil ketika driver klien dibongkar.

Struktur

CLIENT_DEVICE_INFORMATION Struktur CLIENT_DEVICE_INFORMATION digunakan oleh panggilan balik pemberitahuan perangkat keras HWN_CLIENT_QUERY_DEVICE_INFORMATION untuk mengembalikan jumlah total pemberitahuan perangkat keras yang disediakan driver perangkat klien.
HWN_CLIENT_REGISTRATION_PACKET Paket pendaftaran driver klien Pemberitahuan Perangkat Keras yang diteruskan ke ekstensi kelas ketika driver klien terdaftar. Berisi informasi versi dan fungsi panggilan balik driver klien.