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
目標平台	Universal
標頭	swdevice.h
程式庫	Swdevice.lib;Windows 10 上的 OneCoreUAP.lib
Dll	Cfgmgr32.dll