WDF驱动开发-修改设备属性

设备属性编纂了设备实例、 设备设置类、 设备接口类和设备接口的属性。 这些属性描述组件的功能及其在 Windows 操作系统中的配置。

Windows Vista 和更高版本的 Windows 支持统一 的设备属性模型 ，该模型定义这些设备属性的表示方式。

设备属性就是设备管理器里面那些:

访问统一设备属性模型

Windows 驱动程序框架 (WDF) 驱动程序可以检索或修改通过统一设备属性模型公开的属性。 从 User-Mode Driver Framework (UMDF) 版本 2.0 和 Kernel-Mode Driver Framework (KMDF) 1.13 开始，列出的方法可用。

KMDF 和 UMDF 驱动程序都可以调用以下方法：

WdfDeviceAllocAndQueryPropertyEx

WdfDeviceAssignProperty

WdfDeviceQueryPropertyEx

KMDF 和 UMDF 驱动程序只能在调用 WdfDeviceCreate 之前调用以下方法。 

调用 WdfDeviceCreate 后，驱动程序可以通过调用相应的 WdfDeviceXxxProperty 方法获取设备属性信息。

WdfFdoInitAllocAndQueryPropertyEx

WdfFdoInitQueryPropertyEx

上述 -Ex 方法与其非 Ex 方法的不同之处在于，它们允许使用 WDF_DEVICE_PROPERTY_DATA 结构指定属性，而不是使用 DEVICE_REGISTRY_PROPERTY 指定的子集。

在接收设备属性数据之前，驱动程序通常调用 WdfXxxQueryProperty 只是为了获取所需的缓冲区大小。 对于某些属性，数据大小可以在返回所需大小和驱动程序再次调用 WdfXxxQueryProperty 之间更改。 因此，驱动程序应在循环中调用 WdfXxxQueryProperty ，该循环执行到返回状态未 STATUS_BUFFER_TOO_SMALL为止。

最好仅在所需的缓冲区大小已知且不变时才使用 Wdf XxxQueryProperty，因为在这种情况下，驱动程序只需调用 WdfXxxQueryProperty 一次。 如果所需的缓冲区大小未知或变化，驱动程序应调用 WdfXxxAllocAndQueryProperty。

UMDF 驱动程序可以使用以下方法来检索或修改通过统一属性模型公开 的设备接口 属性：

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

若要检索或修改设备接口属性，KMDF 驱动程序必须直接调用 IoGetDeviceInterfacePropertyData 或 IoSetDeviceInterfacePropertyData 。