Fonction SwDevicePropertySet (swdevice.h)

Article
05/03/2024

Définit les propriétés d’un appareil logiciel.

Syntaxe

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

Paramètres

[in] hSwDevice

Le handle HSWDEVICE de l’appareil logiciel pour lequel définir des propriétés.

[in] cPropertyCount

Nombre de structures DEVPROPERTY dans le tableau pProperties .

[in] pProperties

Tableau de structures DEVPROPERTY contenant les propriétés à définir.

Valeur retournée

S_OK est retourné si SwDevicePropertySet a correctement défini les propriétés ; sinon, une valeur d’erreur appropriée.

Remarques

Vous pouvez appeler SwDevicePropertySet uniquement après que le système d’exploitation a appelé la fonction de rappel SW_DEVICE_CREATE_CALLBACK de votre application cliente pour informer l’application cliente que l’énumération de l’appareil s’est terminée.

Il existe une différence subtile entre les propriétés qui sont définies dans le cadre d’un appel SwDeviceCreate et les propriétés qui sont définies ultérieurement en appelant SwDevicePropertySet. Les propriétés définies dans le cadre de SwDeviceCreate sont stockées en mémoire ; si l’appareil est désinstallé ou si un pilote null efface les magasins de propriétés, ces propriétés sont réécrites par la fonctionnalité d’API d’appareil logiciel lorsque PnP réinscrit les appareils. Tout cela est transparent pour le client. Les propriétés définies à l’aide de SwDevicePropertySet après l’énumération ne sont pas conservées en mémoire. Toutefois, si vous définissez une propriété à l’aide de SwDeviceCreate, vous pouvez mettre à jour la valeur avec SwDevicePropertySet, et cette mise à jour est appliquée à la valeur en mémoire ainsi qu’au magasin persistant.

Vous pouvez utiliser SwDevicePropertySet uniquement pour définir des propriétés dans le magasin de système d’exploitation de l’appareil.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Universal
En-tête	swdevice.h
Bibliothèque	Swdevice.lib ; OneCoreUAP.lib sur Windows 10
DLL	Cfgmgr32.dll

Partager via