WinUsb_QueryInterfaceSettings, fonction (winusb.h)
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 |
---|---|
|
L’appelant a passé la valeur NULL dans le paramètre InterfaceHandle . |
|
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
En-tête | winusb.h (inclure Winusb.h) |
Bibliothèque | Winusb.lib |
DLL | Winusb.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour