WinUsb_SetCurrentAlternateSetting-Funktion (winusb.h)

Artikel
08/27/2023

Die WinUsb_SetCurrentAlternateSetting-Funktion legt die alternative Einstellung einer Schnittstelle fest.

Syntax

BOOL WinUsb_SetCurrentAlternateSetting(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   SettingNumber
);

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für eine Schnittstelle, das die festzulegende alternative Einstellung definiert.

Um eine alternative Einstellung in der ersten Schnittstelle auf dem Gerät festzulegen, verwenden Sie das von WinUsb_Initialize zurückgegebene Schnittstellenhandle. Verwenden Sie für alle anderen Schnittstellen das Handle für die Zielschnittstelle, die von WinUsb_GetAssociatedInterface abgerufen wird.

[in] SettingNumber

Der Wert, der im bAlternateSetting-Member der USB_INTERFACE_DESCRIPTOR-Struktur enthalten ist. Diese Struktur wird von der WinUsb_QueryInterfaceSettings-Routine aufgefüllt.

Rückgabewert

WinUsb_SetCurrentAlternateSetting gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion FALSE zurück, und der Aufrufer kann den protokollierten Fehler abrufen, indem er GetLastError aufruft.

GetLastError kann den folgenden Fehlercode zurückgeben.