通过

WdfDeviceAssignProperty 函数 （wdfdevice.h）

  • 项目

[适用于 KMDF 和 UMDF]

WdfDeviceAssignProperty 方法修改设备属性的当前设置。

语法

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

参数

[in] Device

框架设备对象的句柄。

[in] DeviceProperty

指向标识要修改的设备属性的 WDF_DEVICE_PROPERTY_DATA 结构的指针。

[in] Type

一个 DEVPROPTYPE类型化变量，指定存储在 数据中的数据的类型。

[in] Size

数据指向的缓冲区的大小（以字节为单位）。

[in, optional] Data

指向包含设备属性数据的调用方分配缓冲区的指针。 将此参数设置为 NULL 以删除指定的属性。

返回值

如果作成功，WdfDeviceAssignProperty 返回STATUS_SUCCESS。 其他返回值包括：

返回代码 描述
STATUS_INVALID_PARAMETER
 其中一个参数不正确。
 

此方法可能会返回其他 NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

言论

可以使用 WdfDeviceAssignProperty 修改通过统一属性模型公开的任何属性的设置。

有关相关方法的信息，请参阅 访问统一设备属性模型。

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.13
最低 UMDF 版本 2.0
标头 wdfdevice.h （包括 Wdf.h）
库 Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL APC_LEVEL

另请参阅

WdfDeviceAssignInterfaceProperty