WdfDeviceAssignInterfaceProperty 函数 (wdfdevice.h)

  • 项目

重要

仅适用于 UMDF

WdfDeviceAssignInterfaceProperty 方法修改设备接口属性的当前值。

注意

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

语法

NTSTATUS WdfDeviceAssignInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           DEVPROPTYPE                         Type,
  [in]           ULONG                               BufferLength,
  [in, optional] PVOID                               PropertyBuffer
);

参数

[in] Device

框架设备对象的句柄。

[in] PropertyData

指向 WDF_DEVICE_INTERFACE_PROPERTY_DATA 结构的指针。

[in] Type

一个 DEVPROPTYPE 类型的值，该值指定 PropertyBuffer 中提供的数据类型。

[in] BufferLength

指定 PropertyBuffer 指向的缓冲区的长度（以字节为单位）。

[in, optional] PropertyBuffer

指向设备接口属性数据的指针。 将此参数设置为 NULL 可删除指定的属性。

返回值

如果 WdfDeviceAssignInterfaceProperty 方法未遇到任何错误，则返回STATUS_SUCCESS。 其他返回值包括：

返回代码 说明
STATUS_INVALID_PARAMETER 其中一个参数不正确。

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

注解

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

示例

下面的代码示例初始化 WDF_DEVICE_INTERFACE_PROPERTY_DATA 结构，然后调用 WdfDeviceAssignInterfaceProperty。

DEFINE_DEVPROPKEY(DEVPKEY_ToasterCrispLevelDword, 0x5d0ba64a, 0x2396, 0x4bc9, 0xbf, 0x49, 0x52, 0x1d, 0xa6, 0x2b, 0x1b, 0xed, 3);  // DEVPROP_TYPE_UINT32

ULONG crispLevel = 0;
WDF_DEVICE_INTERFACE_PROPERTY_DATA propertyData;

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT(
                          &propertyData, 
                          &GUID_DEVINTERFACE_TOASTER_DRIVER
                          &DEVPKEY_ToasterCrispLevelDword
                          );

status = WdfDeviceAssignInterfaceProperty(device, 
                                          &propertData,
                                          DEVPROP_TYPE_UINT32,
                                          sizeof(crispLevel),
                                          &crispLevel);
if (!NT_SUCCESS(status)) {
    return status;
}

要求

要求 值
最低受支持的客户端 Windows 8.1
目标平台 通用
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceQueryInterfaceProperty