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
ERROR_INVALID_HANDLE	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

Voir aussi

USB_INTERFACE_DESCRIPTOR

WinUSB

Fonctions WinUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings