WdfDeviceSetDeviceInterfaceState, fonction (wdfdevice.h)
[S’applique à KMDF et UMDF]
La méthode WdfDeviceSetDeviceInterfaceState active ou désactive une interface d’appareil pour un appareil spécifié.
Note
Le pilote ne doit appeler cette fonction qu’après le démarrage de l’appareil. Pour modifier l’état de l’interface à partir de l’ajout de l’appareil, 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 vers un objet d’appareil framework.
[in] InterfaceClassGUID
Pointeur vers un GUID qui identifie la classe d’interface d’appareil.
[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 TRUE, active l’instance d’interface d’appareil spécifiée ou, si FAUX, la désactive.
Valeur de retour
Aucun
Remarques
Une vérification de bogue 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 Using Device Interfaces.
Exemples
L’exemple de code suivant désactive l’interface de port COM d’un pilote.
WdfDeviceSetDeviceInterfaceState (
Device,
(LPGUID) &GUID_DEVINTERFACE_COMPORT,
NULL,
FALSE
);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfdevice.h (include 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
WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx