swdevicePropertySet 函数 (swdevice.h)

设置软件设备上的属性。

语法

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

参数

[in] hSwDevice

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

[in] cPropertyCount

pProperties 数组中的 DEVPROPERTY 结构数。

[in] pProperties

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

返回值

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

注解

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

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

只能使用 SwDevicePropertySet 在设备的操作系统存储中设置属性。

要求

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