Compartir a través de


función WinUsb_SetCurrentAlternateSetting (winusb.h)

La función WinUsb_SetCurrentAlternateSetting establece el valor alternativo de una interfaz.

Sintaxis

BOOL WinUsb_SetCurrentAlternateSetting(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   SettingNumber
);

Parámetros

[in] InterfaceHandle

Identificador opaco de una interfaz, que define la configuración alternativa que se va a establecer.

Para establecer una configuración alternativa en la primera interfaz del dispositivo, use el identificador de interfaz devuelto por WinUsb_Initialize. Para todas las demás interfaces, use el identificador para la interfaz de destino, recuperada por WinUsb_GetAssociatedInterface.

[in] SettingNumber

Valor contenido en el miembro bAlternateSetting de la estructura USB_INTERFACE_DESCRIPTOR . Esta estructura se rellena mediante la rutina WinUsb_QueryInterfaceSettings .

Valor devuelto

WinUsb_SetCurrentAlternateSetting devuelve TRUE si la operación se realiza correctamente. De lo contrario, esta función devuelve FALSE y el autor de la llamada puede recuperar el error registrado llamando a GetLastError.

GetLastError puede devolver el siguiente código de error.

Código devuelto Descripción
ERROR_INVALID_HANDLE
El llamador pasó NULL en el parámetro InterfaceHandle .

Comentarios

WinUsb_SetCurrentAlternateSetting produce un error si las solicitudes de E/S pendientes están presentes en la interfaz.

Requisitos

   
Plataforma de destino Universal
Encabezado winusb.h (incluya Winusb.h)
Library Winusb.lib
Archivo DLL Winusb.dll

Consulte también

USB_INTERFACE_DESCRIPTOR

WinUSB

Funciones winUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings