funzione WinUsb_SetCurrentAlternateSetting (winusb.h)
La funzione WinUsb_SetCurrentAlternateSetting imposta l'impostazione alternativa di un'interfaccia.
Sintassi
BOOL WinUsb_SetCurrentAlternateSetting(
[in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
[in] UCHAR SettingNumber
);
Parametri
[in] InterfaceHandle
Handle opaco per un'interfaccia che definisce l'impostazione alternativa da impostare.
Per impostare un'impostazione alternativa nella prima interfaccia del dispositivo, usare l'handle di interfaccia restituito da WinUsb_Initialize. Per tutte le altre interfacce, usare l'handle per l'interfaccia di destinazione, recuperata da WinUsb_GetAssociatedInterface.
[in] SettingNumber
Valore contenuto nel membro bAlternateSetting della struttura USB_INTERFACE_DESCRIPTOR . Questa struttura viene popolata dalla routine WinUsb_QueryInterfaceSettings .
Valore restituito
WinUsb_SetCurrentAlternateSetting restituisce TRUE se l'operazione ha esito positivo. In caso contrario, questa funzione restituisce FALSE e il chiamante può recuperare l'errore registrato chiamando GetLastError.
GetLastError può restituire il codice di errore seguente.
Codice restituito | Descrizione |
---|---|
|
Il chiamante ha passato NULL nel parametro InterfaceHandle . |
Commenti
WinUsb_SetCurrentAlternateSetting ha esito negativo se le richieste di I/O in sospeso sono presenti nell'interfaccia.
Requisiti
Piattaforma di destinazione | Universale |
Intestazione | winusb.h (include Winusb.h) |
Libreria | Winusb.lib |
DLL | Winusb.dll |