Método IWDFUsbInterface::SelectSetting (wudfusb.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método SelectSetting selecciona la configuración alternativa especificada en una interfaz USB.

Sintaxis

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Parámetros

[in] SettingNumber

Configuración que se va a seleccionar en la interfaz USB.

Valor devuelto

SelectSetting devuelve uno de los valores siguientes:

Código devuelto Descripción
S_OK

SelectSetting seleccionó correctamente la configuración que especificó el parámetro SettingNumber .
E_OUTOFMEMORY

SelectSetting encontró un error de asignación.
Código de error definido en Winerror.h
 Este valor corresponde al código de error que devolvió la API de WinUsb.

Comentarios

El marco selecciona automáticamente la configuración cero, su interfaz cero y el valor alternativo cero. Para cambiar la configuración alternativa, el controlador puede llamar a SelectSetting.

Para obtener más información sobre descriptores de configuración de USB

Ejemplos


hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfusb.h (incluya Wudfusb.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFUsbInterface