Fonction SwDeviceInterfacePropertySet (swdevice.h)

Article
05/03/2024

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

Syntaxe

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

Paramètres

[in] hSwDevice

Le handle HSWDEVICE est destiné au périphérique logiciel de l’interface pour laquelle définir les propriétés.

[in] pszDeviceInterfaceId

Chaîne qui identifie l’interface sur laquelle 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 sur l’interface.

Valeur retournée

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

Remarques

Vous pouvez appeler SwDeviceInterfacePropertySet 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 d’appareil s’est terminée.

Il existe une différence subtile entre les propriétés définies dans le cadre d’un appel SwDeviceInterfaceRegister et les propriétés qui sont définies ultérieurement en appelant SwDeviceInterfacePropertySet. Les propriétés définies dans le cadre de SwDeviceInterfaceRegister 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é API de périphérique logiciel lorsque PnP réinscrit les appareils. Tout cela est transparent pour le client. Les propriétés définies à l’aide de SwDeviceInterfacePropertySet après l’énumération ne sont pas conservées en mémoire. Toutefois, si vous définissez une propriété à l’aide de SwDeviceInterfaceRegister, vous pouvez mettre à jour la valeur avec SwDeviceInterfacePropertySet, et cette mise à jour est appliquée à la valeur en mémoire ainsi qu’au magasin persistant.

Vous pouvez utiliser SwDeviceInterfacePropertySet uniquement pour définir les propriétés dans le magasin du système d’exploitation de l’interface.

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