funzione WinUsb_QueryInterfaceSettings (winusb.h)

Articolo
08/27/2023

La funzione WinUsb_QueryInterfaceSettings recupera il descrittore dell'interfaccia per le impostazioni di interfaccia alternative specificate per un handle di interfaccia specifico.

Sintassi

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

Parametri

[in] InterfaceHandle

Handle opaco a un'interfaccia nella configurazione selezionata.

Per recuperare le impostazioni della prima interfaccia, usare l'handle restituito da WinUsb_Initialize. Per tutte le altre interfacce, usare l'handle per l'interfaccia di destinazione, recuperata da WinUsb_GetAssociatedInterface.

[in] AlternateInterfaceNumber

Valore che indica quali impostazioni alternative restituire. Un valore pari a 0 indica la prima impostazione alternativa, un valore pari a 1 indica la seconda impostazione alternativa e così via.

[out] UsbAltInterfaceDescriptor

Puntatore a una struttura di USB_INTERFACE_DESCRIPTOR allocata dal chiamante che contiene informazioni sull'interfaccia specificata da AlternateSettingNumber .

Valore restituito

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

GetLastError può restituire il codice di errore seguente.

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	Il chiamante ha passato NULL nel parametro InterfaceHandle .
ERROR_NO_MORE_ITEMS	Non è stata trovata l'interfaccia alternativa specificata.

Commenti

WinUsb_QueryInterfaceSettings analizza il descrittore di configurazione recuperato in precedenza da WinUsb_Initialize. Per altre informazioni, vedere la sezione Osservazioni per WinUsb_Initialize.

La chiamata WinUsb_QueryInterfaceSettings cerca la matrice di interfaccia per l'interfaccia alternativa specificata dall'indice dell'interfaccia passato dal chiamante in AlternateSettingNumber. Se viene trovata l'interfaccia specificata, la funzione popola la struttura USB_INTERFACE_DESCRIPTOR allocata dal chiamante. Se l'interfaccia specificata non viene trovata, la chiamata ha esito negativo con il codice ERROR_NO_MORE_ITEMS.