硬體通知

Windows 提供與硬體無關的通知元件支援基礎結構，例如 LED 和震動機制。 這項支援是透過引進 Kernel-Mode Driver Framework (KMDF) 類別擴充功能，特別適用于可快速開發用戶端驅動程式的硬體通知元件。 KMDF 類別延伸模組基本上是 KMDF 驅動程式，可為指定的裝置類別提供一組已定義的功能，類似于 Windows 驅動程式模型 (WDM) 中的埠驅動程式。 本節提供硬體通知類別延伸模組架構的概觀。

如需 KMDF 的其他資訊，請參閱 使用 WDF 開發驅動程式。

若要提供硬體通知的支援，您需要：

• hwnclx.h

列舉

HWN_CLX_EXPORT_INDEX 定義匯出資料表中每個硬體通知匯出的位置。

函式

HWN_CLIENT_GET_STATE 由用戶端驅動程式實作，以取得硬體通知元件狀態。 當使用者要求狀態資訊時，就會叫用它。
HWN_CLIENT_INITIALIZE_DEVICE 由用戶端驅動程式實作，並因為呼叫 EVT_WDF_DEVICE_PREPARE_HARDWARE而叫用。
HWN_CLIENT_QUERY_DEVICE_INFORMATION 由用戶端驅動程式實作以擷取硬體通知元件屬性。
HWN_CLIENT_SET_STATE 由用戶端驅動程式實作以設定硬體通知元件狀態。 當使用者想要變更驅動程式的狀態時，就會叫用它。
HWN_CLIENT_START_DEVICE 由用戶端驅動程式實作以啟動硬體通知元件。 它會因為呼叫 EVT_WDF_DEVICE_D0_ENTRY 而叫用。
HWN_CLIENT_STOP_DEVICE 由用戶端驅動程式實作以啟動硬體通知元件。 它會因為呼叫EVT_WDF_DEVICE_D0_EXIT而叫用。
HWN_CLIENT_UNINITIALIZE_DEVICE 由用戶端驅動程式實作，並叫用作為呼叫EVT_WDF_DEVICE_RELEASE_HARDWARE的結果叫用。 此回呼函式會取消初始化硬體通知元件。
HwNProcessAddDevicePostDeviceCreate 建立 I/O 佇列。 在叫用用戶端驅動程式的EVT_WDF_DRIVER_DEVICE_ADD回呼函式並建立裝置物件之後，應該呼叫它。
HwNProcessAddDevicePreDeviceCreate 提供裝置準備/發行和進入/結束回呼給 Windows Driver Foundation (WDF) ，以便將裝置轉換成不同的狀態。
HwNRegisterClient 向類別延伸模組註冊硬體通知用戶端驅動程式及其回呼函式。
HwNUnregisterClient 使用類別延伸模組取消註冊硬體通知用戶端驅動程式及其回呼函式。 卸載用戶端驅動程式時，應該叫用此函式。

結構

CLIENT_DEVICE_INFORMATION 硬體通知回呼HWN_CLIENT_QUERY_DEVICE_INFORMATION會使用CLIENT_DEVICE_INFORMATION結構，以傳回用戶端設備磁碟機所提供的硬體通知總數。
HWN_CLIENT_REGISTRATION_PACKET 註冊用戶端驅動程式時傳遞至類別延伸模組的硬體通知用戶端驅動程式註冊封包。 包含版本資訊和用戶端驅動程式回呼函式。