WinUsb_GetCurrentAlternateSetting-Funktion (winusb.h)

Artikel
08/27/2023

Die WinUsb_GetCurrentAlternateSetting-Funktion ruft die aktuelle alternative Schnittstelleneinstellung für eine Schnittstelle ab. Dies ist ein synchroner Vorgang.

Syntax

BOOL WinUsb_GetCurrentAlternateSetting(
  [in]  WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [out] PUCHAR                  SettingNumber
);

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für eine Schnittstelle in der ausgewählten Konfiguration. Um die aktuelle alternative Einstellung in der ersten (Standard)-Schnittstelle auf dem Gerät abzurufen, 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.

[out] SettingNumber

Ein Zeiger auf ein Zeichen ohne Vorzeichen, das eine ganze Zahl empfängt, die die aktuelle alternative Einstellung angibt.

Rückgabewert

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

GetLastError kann den folgenden Fehlercode zurückgeben.