Share via


fonction WinUsb_AbortPipe (winusb.h)

La fonction WinUsb_AbortPipe annule tous les transferts en attente pour un canal. Il s’agit d’une opération synchrone.

Syntaxe

BOOL WinUsb_AbortPipe(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   PipeID
);

Paramètres

[in] InterfaceHandle

Handle opaque pour une interface qui contient le point de terminaison auquel le canal est associé.

Pour annuler les transferts sur le canal associé au point de terminaison dans 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] PipeID

Identificateur (ID) du canal de contrôle. Le paramètre PipeID est une valeur 8 bits qui se compose d’une adresse 7 bits et d’un bit de direction. Ce paramètre correspond au champ bEndpointAddress dans le descripteur de point de terminaison.

Valeur retournée

WinUsb_AbortPipe 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.

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 .

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_Free

WinUsb_Initialize