WinUsb_GetAssociatedInterface, fonction (winusb.h)

  • Article

La fonction WinUsb_GetAssociatedInterface récupère un handle pour une interface associée. Il s’agit d’une opération synchrone.

Syntaxe

BOOL WinUsb_GetAssociatedInterface(
  [in]  WINUSB_INTERFACE_HANDLE  InterfaceHandle,
  [in]  UCHAR                    AssociatedInterfaceIndex,
  [out] PWINUSB_INTERFACE_HANDLE AssociatedInterfaceHandle
);

Paramètres

[in] InterfaceHandle

Handle opaque à la première interface (par défaut) de l’appareil, qui est retournée par WinUsb_Initialize.

[in] AssociatedInterfaceIndex

Index qui spécifie l’interface associée à récupérer. La valeur 0 indique la première interface associée, la valeur 1 indique la deuxième interface associée, et ainsi de suite.

[out] AssociatedInterfaceHandle

Handle pour l’interface associée. Les appelants doivent passer ce handle d’interface aux fonctions WinUSB exposées par Winusb.dll. Pour fermer ce handle, appelez WinUsb_Free.

Valeur retournée

WinUsb_GetAssociatedInterface retourne TRUE si l’opération réussit. Sinon, cette routine retourne FALSE et l’appelant peut récupérer l’erreur journalisée en appelant GetLastError.

Code de retour Description
ERROR_ALREADY_EXISTS

WinUsb_GetAssociatedInterface a déjà retourné un handle pour l’interface spécifiée par AssociatedInterfaceIndex .
ERROR_INVALID_HANDLE
 L’appelant a passé la valeur NULL dans le paramètre InterfaceHandle .
ERROR_INVALID_PARAMETER
 La valeur AssociatedInterfaceIndex passée a échoué à un dépassement d’entier case activée.
ERROR_NO_MORE_ITEMS
 Il n’existe pas d’interface pour la valeur AssociatedInterfaceIndex spécifiée.
ERROR_NOT_ENOUGH_MEMORY
 Indique que la mémoire est insuffisante pour effectuer l’opération.

Remarques

La routine WinUsb_GetAssociatedInterface récupère un handle opaque.

La première interface associée est l’interface qui suit immédiatement l’interface dont le handle WinUsb_Initialize routine récupère.

Le handle retourné par WinUsb_GetAssociatedInterface doit être libéré en appelant WinUsb_Free.

Les appelants de WinUsb_GetAssociatedInterface peuvent récupérer un seul handle pour chaque interface. Si un appelant tente de récupérer plusieurs handles pour la même interface, la routine échoue avec une erreur de ERROR_ALREADY_EXISTS.

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

WinUSB

Fonctions WinUSB

WinUsb_Initialize