Freigeben über


WinUsb_SetCurrentAlternateSetting-Funktion (winusb.h)

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.

Rückgabecode Beschreibung
ERROR_INVALID_HANDLE
Der Aufrufer hat NULL im Parameter InterfaceHandle übergeben.

Hinweise

WinUsb_SetCurrentAlternateSetting schlägt fehl, wenn ausstehende E/A-Anforderungen auf der Schnittstelle vorhanden sind.

Anforderungen

   
Zielplattform Universell
Header winusb.h (einschließlich Winusb.h)
Bibliothek Winusb.lib
DLL Winusb.dll

Weitere Informationen

USB_INTERFACE_DESCRIPTOR

Winusb

WinUSB-Funktionen

WinUsb_Initialize

WinUsb_QueryInterfaceSettings