IWDFDevice ::AssignDeviceInterfaceState, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode AssignDeviceInterfaceState active ou désactive l’instance d’interface d’appareil spécifiée 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 NULL-terminated qui contient le nom de l’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 passe ne doit pas contenir de caractères de séparation de chemin (« / » ou « \ »).
[in] Enable
Valeur BOOL qui spécifie si l’instance de l’interface de l’appareil doit être activée ou désactivée. TRUE indique l’activation ; FALSE indique la désactivation.
Valeur de retour
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 des interfaces d’appareil dans les pilotes UMDF.
Exemples
Pour obtenir un exemple de code montrant comment utiliser la méthode AssignDeviceInterfaceState, consultez IWDFDevice ::CreateDeviceInterface.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |