WinUsb_ResetPipe-Funktion (winusb.h)

Artikel
08/27/2023

Die funktion WinUsb_ResetPipe setzt den Daten-Umschalter zurück und löscht die Standzustandsbedingung für eine Pipe.

Syntax

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

Parameter

[in] InterfaceHandle

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

Um eine Pipe zurückzusetzen, die einem 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_ResetPipe gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion FALSE zurück, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

GetLastError kann den folgenden Fehlercode zurückgeben.