SwDevicePropertySet-Funktion (swdevice.h)

Artikel
05/03/2024

Legt Eigenschaften auf einem Softwaregerät fest.

Syntax

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

Parameter

[in] hSwDevice

Das HSWDEVICE-Handle für das Softwaregerät, für das Eigenschaften festgelegt werden sollen.

[in] cPropertyCount

Die Anzahl der DEVPROPERTY-Strukturen im pProperties-Array .

[in] pProperties

Ein Array von DEVPROPERTY-Strukturen , die die festzulegenden Eigenschaften enthalten.

Rückgabewert

S_OK wird zurückgegeben, wenn SwDevicePropertySet die Eigenschaften erfolgreich festgelegt hat. andernfalls ein geeigneter Fehlerwert.

Hinweise

Sie können SwDevicePropertySet erst aufrufen, nachdem das Betriebssystem die SW_DEVICE_CREATE_CALLBACK Rückruffunktion Ihrer Client-App aufgerufen hat, um die Client-App darüber zu benachrichtigen, dass die Geräteenumeration abgeschlossen ist.

Es gibt einen geringfügigen Unterschied zwischen Eigenschaften, die als Teil eines SwDeviceCreate-Aufrufs festgelegt werden, und Eigenschaften, die später durch Aufrufen von SwDevicePropertySet festgelegt werden. Eigenschaften, die als Teil von SwDeviceCreate festgelegt werden, werden im Arbeitsspeicher gespeichert. Wenn das Gerät deinstalliert wird oder ein NULL-Treiber die Eigenschaftenspeicher löscht, werden diese Eigenschaften von der Softwaregeräte-API-Funktion erneut geschrieben, wenn PnP die Geräte erneut aufzählt. Dies alles ist für den Client transparent. Eigenschaften, die mit SwDevicePropertySet nach der Enumeration festgelegt werden, bleiben nicht im Arbeitsspeicher erhalten. Wenn Sie jedoch eine Eigenschaft mithilfe von SwDeviceCreate festlegen, können Sie den Wert mit SwDevicePropertySet aktualisieren, und dieses Update wird sowohl auf den Wert im Arbeitsspeicher als auch auf den persistenten Speicher angewendet.

Sie können SwDevicePropertySet nur verwenden, um Eigenschaften im Betriebssystemspeicher für das Gerät festzulegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Universell
Header	swdevice.h
Bibliothek	Swdevice.lib; OneCoreUAP.lib auf Windows 10
DLL	Cfgmgr32.dll

Freigeben über