WinUsb_QueryInterfaceSettings, fonction (winusb.h)

Article
03/04/2024

La fonction WinUsb_QueryInterfaceSettings récupère le descripteur d’interface pour les autres paramètres d’interface spécifiés pour un handle d’interface particulier.

Syntaxe

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Paramètres

[in] InterfaceHandle

Handle opaque pour une interface dans la configuration sélectionnée.

Pour récupérer les paramètres de la première interface, utilisez le handle retourné par WinUsb_Initialize. Pour toutes les autres interfaces, utilisez le handle de l’interface cible, récupéré par WinUsb_GetAssociatedInterface.

[in] AlternateInterfaceNumber

Valeur qui indique les autres paramètres à retourner. La valeur 0 indique le premier autre paramètre, la valeur 1 indique le deuxième paramètre de remplacement, et ainsi de suite.

[out] UsbAltInterfaceDescriptor

Pointeur vers une structure de USB_INTERFACE_DESCRIPTOR allouée à l’appelant qui contient des informations sur l’interface spécifiée par AlternateSettingNumber .

Valeur retournée

WinUsb_QueryInterfaceSettings retourne TRUE si l’opération réussit. Sinon, elle 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 .
ERROR_NO_MORE_ITEMS	L’autre interface spécifiée est introuvable.

Remarques

WinUsb_QueryInterfaceSettings analyse le descripteur de configuration précédemment récupéré par WinUsb_Initialize. Pour plus d’informations, consultez la section Remarques pour WinUsb_Initialize.

L’appel WinUsb_QueryInterfaceSettings recherche dans le tableau d’interface l’autre interface spécifiée par l’index d’interface transmis par l’appelant dans le AlternateSettingNumber. Si l’interface spécifiée est trouvée, la fonction remplit la structure USB_INTERFACE_DESCRIPTOR allouée à l’appelant . Si l’interface spécifiée est introuvable, l’appel échoue avec le code ERROR_NO_MORE_ITEMS.