WinUsb_AbortPipe-Funktion (winusb.h)

Die WinUsb_AbortPipe-Funktion bricht alle ausstehenden Übertragungen für eine Pipe ab. Dies ist ein synchroner Vorgang.

Syntax

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

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für eine Schnittstelle, die den Endpunkt enthält, dem die Pipe zugeordnet ist.

Um Übertragungen auf der Pipe abzubrechen, die dem Endpunkt in der ersten Schnittstelle zugeordnet ist, verwenden Sie das von WinUsb_Initialize zurückgegebene Handle. Verwenden Sie für alle anderen Schnittstellen das Handle für die Zielschnittstelle, das von WinUsb_GetAssociatedInterface abgerufen wird.

[in] PipeID

Der Bezeichner (ID) der Steuerelementpipe. Der PipeID-Parameter ist ein 8-Bit-Wert, der aus einer 7-Bit-Adresse und einem Richtungsbit besteht. Dieser Parameter entspricht dem Feld bEndpointAddress im Endpunktdeskriptor.

Rückgabewert

WinUsb_AbortPipe gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine FALSE zurück, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

GetLastError kann den folgenden Fehlercode zurückgeben.

Rückgabecode Beschreibung
ERROR_INVALID_HANDLE
Der Aufrufer hat NULL im Parameter InterfaceHandle übergeben.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header winusb.h (winusb.h einschließen)
Bibliothek Winusb.lib
DLL Winusb.dll

Weitere Informationen

Winusb

WinUSB-Funktionen

WinUsb_Free

WinUsb_Initialize