IWDFUsbInterface ::SelectSetting, méthode (wudfusb.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 SelectSetting sélectionne le paramètre secondaire spécifié sur une interface USB.
Syntaxe
HRESULT SelectSetting(
[in] UCHAR SettingNumber
);
Paramètres
[in] SettingNumber
Paramètre à sélectionner sur l’interface USB.
Valeur de retour
SelectSetting retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
|
SelectSetting a correctement sélectionné le paramètre spécifié par le paramètre SettingNumber spécifié. |
|
SelectSetting a rencontré un échec d’allocation. |
|
Cette valeur correspond au code d’erreur retourné par l’API WinUsb. |
Remarques
L’infrastructure sélectionne automatiquement la configuration zéro, son interface zéro et le paramètre de remplacement zéro. Pour modifier le paramètre de remplacement, le pilote peut appeler SelectSetting.
Pour plus d’informations descripteurs de configuration USB
Exemples
hr = pIWDFUsbInterface->SelectSetting(SettingNumber);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 | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |