WinUsb_GetAssociatedInterface-Funktion (winusb.h)

  • Artikel

Die WinUsb_GetAssociatedInterface-Funktion ruft ein Handle für eine zugeordnete Schnittstelle ab. Dies ist ein synchroner Vorgang.

Syntax

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

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für die erste (Standard-)Schnittstelle auf dem Gerät, das von WinUsb_Initialize zurückgegeben wird.

[in] AssociatedInterfaceIndex

Ein Index, der die abzurufende zugeordnete Schnittstelle angibt. Der Wert 0 gibt die erste zugeordnete Schnittstelle an, der Wert 1 die zweite zugeordnete Schnittstelle usw.

[out] AssociatedInterfaceHandle

Ein Handle für die zugeordnete Schnittstelle. Aufrufer müssen dieses Schnittstellenhandle an WinUSB Functions übergeben, die von Winusb.dll verfügbar gemacht werden. Rufen Sie WinUsb_Free auf, um dieses Handle zu schließen.

Rückgabewert

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

Rückgabecode Beschreibung
ERROR_ALREADY_EXISTS

WinUsb_GetAssociatedInterface hat bereits ein Handle für die Schnittstelle zurückgegeben, die AssociatedInterfaceIndex angibt.
ERROR_INVALID_HANDLE
 Der Aufrufer hat NULL im Parameter InterfaceHandle übergeben.
ERROR_INVALID_PARAMETER
 Der übergebene AssociatedInterfaceIndex-Wert ist bei einer Ganzzahlüberlaufüberprüfung fehlgeschlagen.
ERROR_NO_MORE_ITEMS
 Für den angegebenen AssociatedInterfaceIndex-Wert ist keine Schnittstelle vorhanden.
ERROR_NOT_ENOUGH_MEMORY
 Gibt an, dass nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden ist.

Hinweise

Die WinUsb_GetAssociatedInterface Routine ruft ein undurchsichtiges Handle ab.

Die erste zugeordnete Schnittstelle ist die Schnittstelle, die unmittelbar auf die Schnittstelle folgt, deren Handle die WinUsb_Initialize Routine abruft.

Das von WinUsb_GetAssociatedInterface zurückgegebene Handle muss durch Aufrufen von WinUsb_Free freigegeben werden.

Aufrufer von WinUsb_GetAssociatedInterface können nur ein Handle für jede Schnittstelle abrufen. Wenn ein Aufrufer versucht, mehr als ein Handle für dieselbe Schnittstelle abzurufen, schlägt die Routine mit dem Fehler ERROR_ALREADY_EXISTS fehl.

Anforderungen

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

Weitere Informationen

Winusb

WinUSB-Funktionen

WinUsb_Initialize