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

Vedi anche

USB_INTERFACE_DESCRIPTOR

WinUSB

Funzioni WinUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings