funzione WinUsb_GetAssociatedInterface (winusb.h)

Articolo
03/13/2024

La funzione WinUsb_GetAssociatedInterface recupera un handle per un'interfaccia associata. Si tratta di un'operazione sincrona.

Sintassi

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

Parametri

[in] InterfaceHandle

Handle opaco per la prima interfaccia (predefinita) nel dispositivo, restituita da WinUsb_Initialize.

[in] AssociatedInterfaceIndex

Indice che specifica l'interfaccia associata da recuperare. Il valore 0 indica la prima interfaccia associata, il valore 1 indica la seconda interfaccia associata e così via.

[out] AssociatedInterfaceHandle

Handle per l'interfaccia associata. I chiamanti devono passare questo handle di interfaccia alle funzioni WinUSB esposte da Winusb.dll. Per chiudere questo handle, chiamare WinUsb_Free.

Valore restituito

WinUsb_GetAssociatedInterface restituisce TRUE se l'operazione ha esito positivo. In caso contrario, questa routine restituisce FALSE e il chiamante può recuperare l'errore registrato chiamando GetLastError.

Codice restituito	Descrizione
ERROR_ALREADY_EXISTS	WinUsb_GetAssociatedInterface ha già restituito un handle per l'interfaccia specificata da AssociatedInterfaceIndex .
ERROR_INVALID_HANDLE	Il chiamante ha passato NULL nel parametro InterfaceHandle .
ERROR_INVALID_PARAMETER	Il valore AssociatedInterfaceIndex passato ha eseguito il failover di un controllo di overflow integer.
ERROR_NO_MORE_ITEMS	Un'interfaccia non esiste per il valore AssociatedInterfaceIndex specificato.
ERROR_NOT_ENOUGH_MEMORY	Indica che la memoria non è sufficiente per eseguire l'operazione.

Commenti

La routine WinUsb_GetAssociatedInterface recupera un handle opaco.

La prima interfaccia associata è l'interfaccia che segue immediatamente l'interfaccia il cui handle viene recuperato dalla routine WinUsb_Initialize .

L'handle restituito WinUsb_GetAssociatedInterface deve essere rilasciato chiamando WinUsb_Free.

I chiamanti di WinUsb_GetAssociatedInterface possono recuperare un solo handle per ogni interfaccia. Se un chiamante tenta di recuperare più handle per la stessa interfaccia, la routine avrà esito negativo con un errore di ERROR_ALREADY_EXISTS.