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 定義匯出資料表中每個硬體通知匯出的位置。 |