WinUsb_GetAssociatedInterface-Funktion (winusb.h)
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 |