WdfDeviceSetDeviceInterfaceStateEx, fonction (wdfdevice.h)
La méthode WdfDeviceSetDeviceInterfaceStateEx active ou désactive une interface d’appareil pour un appareil spécifié.
Syntaxe
void WdfDeviceSetDeviceInterfaceStateEx(
WDFDEVICE Device,
const GUID *InterfaceClassGUID,
PCUNICODE_STRING ReferenceString,
BOOLEAN IsInterfaceEnabled
);
Paramètres
Device
Handle d’un objet d’appareil framework.
InterfaceClassGUID
Pointeur vers un GUID qui identifie la classe d’interface d’appareil.
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.
IsInterfaceEnabled
Valeur booléenne qui, si TRUE, active l’interface d’appareil spécifiée instance ou, si FALSE, la désactive.
Valeur de retour
None
Remarques
Le pilote peut appeler cette fonction avant ou après le démarrage de l’appareil.
Lorsqu’il est appelé avant le démarrage de l’appareil (par exemple à partir d’EvtDriverDeviceAdd, EvtChildListCreateDevice ou EvtDevicePrepareHardware), le pilote doit définir IsInterfaceEnabled sur FALSE pour empêcher l’activation automatique de l’interface lors du démarrage PnP. La définition du paramètre sur TRUE avant le démarrage de l’appareil est redondante et un tel appel doit être supprimé.
Lorsque vous appelez après le démarrage de l’appareil, le comportement est le même que WdfDeviceSetDeviceInterfaceState.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 2004 |
| Version KMDF minimale | 1,31 |
| Version UMDF minimale | 1,31 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |