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é.
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
WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx