访问统一设备属性模型

本主题介绍 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 的详细信息，请参阅 创建框架设备对象。

调用 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 。