hwnclx.h 標頭

此標頭會定義提供通知元件的硬體無關支援所需的程序設計介面，例如LED和震動機制。 這項支援是透過引進 Kernel-Mode Driver Framework （KMDF） 類別延伸模組，特別針對允許快速開發客戶端驅動程式的硬體通知元件提供。 KMDF 類別擴充功能基本上是 KMDF 驅動程式，可提供指定裝置類別的一組已定義功能，類似於 Windows 驅動程式模型 （WDM） 中的埠驅動程式。 本節提供硬體通知類別延伸模組架構的概觀。 如需 KMDF 的其他資訊，請參閱

如需詳細資訊，請參閱：

• 硬體通知設計指南

hwnclx.h 包含下列程序設計介面：

功能

HwNProcessAddDevicePostDeviceCreate 建立 I/O 佇列。 在叫用用戶端驅動程式的EVT_WDF_DRIVER_DEVICE_ADD回呼函式並建立裝置對象之後，應該呼叫它。
HwNProcessAddDevicePreDeviceCreate 提供裝置準備/發行和進入/結束回呼給 Windows Driver Foundation （WDF），以便將裝置轉換成不同的狀態。
HwNRegisterClient 使用類別延伸模組註冊硬體通知用戶端驅動程式及其回呼函式。
HwNUnregisterClient 使用類別延伸模組取消註冊硬體通知客戶端驅動程式及其回呼函式。 卸除客戶端驅動程式時，應該叫用此函式。

回呼函式

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時叫用為叫用。 此回呼函式不會初始化硬體通知元件。

結構

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

枚舉

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