Fonction SwDeviceInterfaceSetState (swdevice.h)

Article
08/26/2023

Active ou désactive une interface d’appareil pour un périphérique logiciel.

Syntaxe

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

Paramètres

[in] hSwDevice

Le handle HSWDEVICE vers l’appareil logiciel pour lequel inscrire une interface d’appareil.

[in] pszDeviceInterfaceId

Chaîne qui identifie l’interface à activer ou désactiver.

[in] fEnabled

Valeur booléenne qui indique s’il faut activer ou désactiver l’interface. TRUE pour activer ; FALSE à désactiver.

Valeur retournée

S_OK est retourné si SwDeviceInterfaceSetState a correctement activé ou désactivé l’interface ; sinon, une valeur d’erreur appropriée.

Remarques

Vous pouvez appeler SwDeviceInterfaceSetState 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.

Vous pouvez uniquement utiliser SwDeviceInterfaceSetState pour gérer les interfaces précédemment inscrites auprès de SwDeviceInterfaceRegister sur l’appareil logiciel représenté par hSwDevice .

Les applications clientes utilisent SwDeviceInterfaceSetState pour gérer l’état qu’elles souhaitent que l’interface ait. L’appareil logiciel modifie l’état réel de l’interface en fonction des besoins. Par exemple, une application cliente désactive et réactive l’interface si l’appareil est réinscrit pour une raison quelconque. L’état tente toujours de refléter l’état requis de l’application cliente.

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