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 |
---|---|
|
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 |