hwnclx.h 标头

此标头定义提供通知组件（如 LED 和振动机制）的硬件不可知支持所需的编程接口。 实现此支持的方式是引入内核模式驱动程序框架 (KMDF) 类扩展，该扩展专用于硬件通知组件，因此可以快速开发客户端驱动程序。 KMDF 类扩展实质上是 KMDF 驱动程序，它为给定的设备类提供一组定义的功能，类似于 Windows 驱动程序模型 (WDM) 中的端口驱动程序。 此部分概述硬件通知类扩展的体系结构。 有关 KMDF 的其他信息，请参阅

有关详细信息，请参阅：

• 硬件通知设计指南

hwnclx.h 包含以下编程接口：

函数

HwNProcessAddDevicePostDeviceCreate 创建 I/O 队列。 应在调用客户端驱动程序的EVT_WDF_DRIVER_DEVICE_ADD回调函数并创建设备对象后调用它。
HwNProcessAddDevicePreDeviceCreate 将设备准备/释放和进入/退出回调提供给 Windows 驱动程序基础 (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 硬件通知回调HWN_CLIENT_QUERY_DEVICE_INFORMATION使用CLIENT_DEVICE_INFORMATION结构返回客户端设备驱动程序提供的硬件通知总数。
HWN_CLIENT_REGISTRATION_PACKET 硬件通知客户端驱动程序注册数据包，在注册客户端驱动程序时传递给类扩展。 包含版本信息和客户端驱动程序回调函数。

枚举

HWN_CLX_EXPORT_INDEX 定义导出表中每个硬件通知导出的位置。