WinUsb_FlushPipe-Funktion (winusb.h)

Artikel
08/27/2023

Die funktion WinUsb_FlushPipe verwirft alle Daten, die in einer Pipe zwischengespeichert sind. Dies ist ein synchroner Vorgang.

Syntax

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

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für die Schnittstelle, der der Endpunkt der angegebenen Pipe zugeordnet ist. Um Daten in einer Pipe zu löschen, die dem Endpunkt auf der ersten (Standard-)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_FlushPipe 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.