Méthode IWDFDevice ::AssignDeviceInterfaceState (wudfddi.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode AssignDeviceInterfaceState active ou désactive l’interface d’appareil spécifiée instance pour un appareil.

Syntaxe

HRESULT AssignDeviceInterfaceState(
  [in]           LPCGUID pDeviceInterfaceGuid,
  [in, optional] PCWSTR  pReferenceString,
  [in]           BOOL    Enable
);

Paramètres

[in] pDeviceInterfaceGuid

Pointeur vers le GUID d’une classe d’interface d’appareil.

[in, optional] pReferenceString

Pointeur vers une chaîne terminée par NULL qui contient le nom du instance de l’interface de l’appareil. Ce paramètre est facultatif. Le pilote peut passer null si le pilote n’a pas à fournir de nom. Si le pilote doit fournir un nom, la chaîne que le pilote transmet ne doit pas contenir de caractères séparateurs de chemin (« / » ou « \ »).

[in] Enable

Valeur BOOL qui spécifie si l’interface de l’appareil instance doit être activée ou désactivée. TRUE indique d’activer ; FALSE indique de désactiver.

Valeur retournée

AssignDeviceInterfaceState retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Remarques

Si IWDFDevice ::CreateDeviceInterface réussit, l’infrastructure active et désactive automatiquement l’interface en fonction de l’état PnP de l’appareil.

Utilisez la méthode AssignDeviceInterfaceState pour désactiver et réactiver manuellement une interface d’appareil.

Pour plus d’informations sur les interfaces d’appareil, consultez Utilisation d’interfaces de périphérique dans les pilotes UMDF.

Exemples

Pour obtenir un exemple de code montrant comment utiliser la méthode AssignDeviceInterfaceState , consultez IWDFDevice ::CreateDeviceInterface.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.5
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IWDFDevice

IWDFDevice ::CreateDeviceInterface