访问统一设备属性模型

本主题介绍如何Windows驱动程序框架 (WDF) 驱动程序检索或修改通过统一设备属性模型公开的属性。 从 User-Mode Driver Framework (UMDF) 版本 2.0 开始,Kernel-Mode Driver Framework (KMDF) 版本 1.13 开始,列出了这些方法。

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

KMDF 和 UMDF 驱动程序只能在调用 WdfDeviceCreate 之前调用以下方法。 有关调用 WdfDeviceCreate 的详细信息,请参阅 创建框架设备对象

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

上述 -Ex 方法与其非 Ex 方法不同,因为它们允许你使用 WDF_DEVICE_PROPERTY_DATA 结构指定属性,而不是可以使用 DEVICE_REGISTRY_PROPERTY指定的子集。

在接收设备属性数据之前,驱动程序通常会调用 WdfXxxQueryProperty 来获取所需的缓冲区大小。 对于某些属性,数据大小可以在返回所需大小和驱动程序再次调用 WdfXxxQueryProperty 时发生更改。 因此,驱动程序应在执行到返回状态未STATUS_BUFFER_TOO_SMALL的循环内调用 WdfXxxQueryProperty

最好仅在所需的缓冲区大小已知且未更改时才使用 WdfXxxQueryProperty,因为在这种情况下,驱动程序必须仅调用一次 WdfXxxQueryProperty。 如果所需的缓冲区大小未知或不同,驱动程序应调用 WdfXxxAllocAndQueryProperty

访问设备接口属性

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

若要检索或修改设备接口属性,KMDF 驱动程序必须直接调用 IoGetDeviceInterfacePropertyDataIoSetDeviceInterfacePropertyData