Partager via


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