Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
WinUsb_GetAssociatedInterface hat bereits ein Handle für die Schnittstelle zurückgegeben, die AssociatedInterfaceIndex angibt. |
|
Der Aufrufer hat NULL im Parameter InterfaceHandle übergeben. |
|
Der übergebene AssociatedInterfaceIndex-Wert ist bei einer Ganzzahlüberlaufüberprüfung fehlgeschlagen. |
|
Für den angegebenen AssociatedInterfaceIndex-Wert ist keine Schnittstelle vorhanden. |
|
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 |