SwDeviceInterfacePropertySet 函数 (swdevice.h)

设置软件设备接口的属性。

语法

HRESULT SwDeviceInterfacePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] PCWSTR            pszDeviceInterfaceId,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

参数

[in] hSwDevice

要为其设置属性的接口的软件设备的 HSWDEVICE 句柄。

[in] pszDeviceInterfaceId

一个字符串，标识要设置属性的接口。

[in] cPropertyCount

pProperties 数组中的 DEVPROPERTY 结构数。

[in] pProperties

包含要对接口设置的属性的 DEVPROPERTY 结构的数组。

返回值

如果 SwDeviceInterfacePropertySet 成功设置接口上的属性，则返回S_OK;否则为适当的错误值。

注解

只有在操作系统调用客户端应用的SW_DEVICE_CREATE_CALLBACK回调函数以通知客户端应用设备枚举已完成之后，才能调用 SwDeviceInterfacePropertySet。

作为 SwDeviceInterfaceRegister 调用的一部分设置的属性与稍后通过调用 SwDeviceInterfacePropertySet 设置的属性之间存在细微区别。 设置为 SwDeviceInterfaceRegister 一部分的属性存储在内存中;如果卸载设备或 null 驱动程序擦除属性存储，则当 PnP 重新枚举设备时，软件设备 API 功能会再次写出这些属性。 这一切都对客户端是透明的。 枚举后使用 SwDeviceInterfacePropertySet 设置的属性不会保留在内存中。 但是，如果使用 SwDeviceInterfaceRegister 设置属性，则可以使用 SwDeviceInterfacePropertySet 更新值，此更新将应用于内存中值以及持久存储。

只能使用 SwDeviceInterfacePropertySet 在操作系统存储中为接口设置属性。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
目标平台	通用
标头	swdevice.h
Library	Swdevice.lib;Windows 10 上的 OneCoreUAP.lib
DLL	Cfgmgr32.dll