fonction WinUsb_SetCurrentAlternateSetting (winusb.h)
La fonction WinUsb_SetCurrentAlternateSetting définit le paramètre de remplacement d’une interface.
Syntaxe
BOOL WinUsb_SetCurrentAlternateSetting(
[in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
[in] UCHAR SettingNumber
);
Paramètres
[in] InterfaceHandle
Handle opaque pour une interface, qui définit l’autre paramètre à définir.
Pour définir un autre paramètre dans la première interface sur l’appareil, utilisez le handle d’interface retourné par WinUsb_Initialize. Pour toutes les autres interfaces, utilisez le handle de l’interface cible, récupéré par WinUsb_GetAssociatedInterface.
[in] SettingNumber
Valeur contenue dans le membre bAlternateSetting de la structure USB_INTERFACE_DESCRIPTOR . Cette structure est remplie par la routine WinUsb_QueryInterfaceSettings .
Valeur retournée
WinUsb_SetCurrentAlternateSetting retourne TRUE si l’opération réussit. Sinon, cette fonction retourne FALSE et l’appelant peut récupérer l’erreur journalisée en appelant GetLastError.
GetLastError peut retourner le code d’erreur suivant.
Code de retour | Description |
---|---|
|
L’appelant a passé la valeur NULL dans le paramètre InterfaceHandle . |
Remarques
WinUsb_SetCurrentAlternateSetting échoue si des demandes d’E/S en suspens sont présentes sur l’interface.
Configuration requise
Plateforme cible | Universal |
En-tête | winusb.h (inclure Winusb.h) |
Bibliothèque | Winusb.lib |
DLL | Winusb.dll |