WinUsb_QueryInterfaceSettings-Funktion (winusb.h)

Artikel
03/06/2024

Die funktion WinUsb_QueryInterfaceSettings ruft den Schnittstellendeskriptor für die angegebenen alternativen Schnittstelleneinstellungen für ein bestimmtes Schnittstellenhandle ab.

Syntax

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für eine Schnittstelle in der ausgewählten Konfiguration.

Verwenden Sie zum Abrufen der Einstellungen der ersten Schnittstelle 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] AlternateInterfaceNumber

Ein -Wert, der angibt, welche alternativen Einstellungen zurückgegeben werden sollen. Der Wert 0 gibt die erste alternative Einstellung an, der Wert 1 die zweite alternative Einstellung usw.

[out] UsbAltInterfaceDescriptor

Ein Zeiger auf eine vom Aufrufer zugeordnete USB_INTERFACE_DESCRIPTOR Struktur, die Informationen über die Schnittstelle enthält, die AlternateSettingNumber angegeben hat.

Rückgabewert

WinUsb_QueryInterfaceSettings gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

GetLastError kann den folgenden Fehlercode zurückgeben.

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Der Aufrufer hat NULL im Parameter InterfaceHandle übergeben.
ERROR_NO_MORE_ITEMS	Die angegebene alternative Schnittstelle wurde nicht gefunden.

Hinweise

WinUsb_QueryInterfaceSettings analysiert den Konfigurationsdeskriptor, der zuvor von WinUsb_Initialize abgerufen wurde. Weitere Informationen finden Sie im Abschnitt Hinweise zu WinUsb_Initialize.

Der WinUsb_QueryInterfaceSettings Aufruf durchsucht das Schnittstellenarray nach der alternativen Schnittstelle, die durch den Schnittstellenindex angegeben wird, der vom Aufrufer in AlternateSettingNumber übergeben wird. Wenn die angegebene Schnittstelle gefunden wird, füllt die Funktion die USB_INTERFACE_DESCRIPTOR Struktur des Aufrufers auf. Wenn die angegebene Schnittstelle nicht gefunden wird, schlägt der Aufruf mit dem ERROR_NO_MORE_ITEMS Code fehl.