función WinUsb_QueryInterfaceSettings (winusb.h)

Artículo
08/27/2023

La función WinUsb_QueryInterfaceSettings recupera el descriptor de interfaz para la configuración de interfaz alternativa especificada para un identificador de interfaz determinado.

Sintaxis

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Parámetros

[in] InterfaceHandle

Identificador opaco de una interfaz en la configuración seleccionada.

Para recuperar la configuración de la primera interfaz, use el identificador devuelto por WinUsb_Initialize. Para todas las demás interfaces, use el identificador para la interfaz de destino, recuperada por WinUsb_GetAssociatedInterface.

[in] AlternateInterfaceNumber

Valor que indica qué configuración alternativa se va a devolver. Un valor de 0 indica la primera configuración alternativa, un valor de 1 indica la segunda configuración alternativa, etc.

[out] UsbAltInterfaceDescriptor

Puntero a una estructura de USB_INTERFACE_DESCRIPTOR asignada por el autor de la llamada que contiene información sobre la interfaz especificada por AlternateSettingNumber .

Valor devuelto

WinUsb_QueryInterfaceSettings devuelve TRUE si la operación se realiza correctamente. De lo contrario, 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 .
ERROR_NO_MORE_ITEMS	No se encontró la interfaz alternativa especificada.

Comentarios

WinUsb_QueryInterfaceSettings analiza el descriptor de configuración recuperado previamente por WinUsb_Initialize. Para obtener más información, vea la sección Comentarios para WinUsb_Initialize.

La llamada WinUsb_QueryInterfaceSettings busca en la matriz de interfaz la interfaz alternativa especificada por el índice de interfaz pasado por el autor de la llamada en AlternateSettingNumber. Si se encuentra la interfaz especificada, la función rellena la estructura de USB_INTERFACE_DESCRIPTOR asignada por el autor de la llamada. Si no se encuentra la interfaz especificada, se produce un error en la llamada con el código ERROR_NO_MORE_ITEMS.