WdfDeviceSetDeviceInterfaceState, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfDeviceSetDeviceInterfaceState active ou désactive une interface d’appareil pour un appareil spécifié.

Notes

Le pilote doit appeler cette fonction uniquement après le démarrage de l’appareil. Pour modifier l’état de l’interface à partir de device add, appelez wdfDeviceSetDeviceInterfaceStateEx à la place.

Syntaxe

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] InterfaceClassGUID

Pointeur vers un GUID qui identifie la classe d’interface de périphérique.

[in, optional] ReferenceString

Pointeur vers une structure UNICODE_STRING qui décrit une chaîne de référence pour l’interface de l’appareil. Ce paramètre est facultatif et peut être NULL.

[in] IsInterfaceEnabled

Valeur booléenne qui, si elle est TRUE, active l’interface d’appareil spécifiée instance ou, si false, la désactive.

Valeur de retour

None

Remarques

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Pour plus d’informations sur les interfaces d’appareil et la méthode WdfDeviceSetDeviceInterfaceState , consultez Utilisation d’interfaces d’appareil.

Exemples

L’exemple de code suivant désactive l’interface de port COM d’un pilote.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfdevice.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx