función WinUsb_GetAssociatedInterface (winusb.h)

Artículo
08/27/2023

La función WinUsb_GetAssociatedInterface recupera un identificador para una interfaz asociada. Se trata de una operación sincrónica.

Sintaxis

BOOL WinUsb_GetAssociatedInterface(
  [in]  WINUSB_INTERFACE_HANDLE  InterfaceHandle,
  [in]  UCHAR                    AssociatedInterfaceIndex,
  [out] PWINUSB_INTERFACE_HANDLE AssociatedInterfaceHandle
);

Parámetros

[in] InterfaceHandle

Identificador opaco de la primera interfaz (predeterminada) del dispositivo, que devuelve WinUsb_Initialize.

[in] AssociatedInterfaceIndex

Índice que especifica la interfaz asociada que se va a recuperar. Un valor de 0 indica la primera interfaz asociada, un valor de 1 indica la segunda interfaz asociada, etc.

[out] AssociatedInterfaceHandle

Identificador de la interfaz asociada. Los autores de llamadas deben pasar este identificador de interfaz a las funciones de WinUSB expuestas por Winusb.dll. Para cerrar este identificador, llame a WinUsb_Free.

Valor devuelto

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

Código devuelto	Descripción
ERROR_ALREADY_EXISTS	WinUsb_GetAssociatedInterface ya ha devuelto un identificador para la interfaz que especifica AssociatedInterfaceIndex .
ERROR_INVALID_HANDLE	El llamador pasó NULL en el parámetro InterfaceHandle .
ERROR_INVALID_PARAMETER	El valor associatedInterfaceIndex pasado produjo un error en una comprobación de desbordamiento de enteros.
ERROR_NO_MORE_ITEMS	No existe una interfaz para el valor AssociatedInterfaceIndex especificado.
ERROR_NOT_ENOUGH_MEMORY	Indica que no hay memoria suficiente para realizar la operación.

Comentarios

La rutina WinUsb_GetAssociatedInterface recupera un identificador opaco.

La primera interfaz asociada es la interfaz que sigue inmediatamente a la interfaz cuyo identificador recupera la rutina WinUsb_Initialize .

El identificador que devuelve WinUsb_GetAssociatedInterface debe liberarse llamando a WinUsb_Free.

Los autores de llamadas de WinUsb_GetAssociatedInterface solo pueden recuperar un identificador para cada interfaz. Si un llamador intenta recuperar más de un identificador para la misma interfaz, se producirá un error en la rutina de ERROR_ALREADY_EXISTS.