struttura USB_BUS_INTERFACE_USBDI_V0 (usbbusif.h)

Articolo
02/07/2025

La struttura USB_BUS_INTERFACE_USBDI_V0 viene fornita dal driver dell'hub USB per consentire ai client USB di effettuare chiamate dirette al driver hub senza allocare i runtime di integrazione.

Sintassi

typedef struct _USB_BUS_INTERFACE_USBDI_V0 {
  USHORT                             Size;
  USHORT                             Version;
  PVOID                              BusContext;
  PINTERFACE_REFERENCE               InterfaceReference;
  PINTERFACE_DEREFERENCE             InterfaceDereference;
  PUSB_BUSIFFN_GETUSBDI_VERSION      GetUSBDIVersion;
  PUSB_BUSIFFN_QUERY_BUS_TIME        QueryBusTime;
  PUSB_BUSIFFN_SUBMIT_ISO_OUT_URB    SubmitIsoOutUrb;
  PUSB_BUSIFFN_QUERY_BUS_INFORMATION QueryBusInformation;
} USB_BUS_INTERFACE_USBDI_V0, *PUSB_BUS_INTERFACE_USBDI_V0;

Membri

Size

Specifica le dimensioni in byte del buffer che contiene i puntatori di interfaccia.

Version

Indica, in base all'input, la versione dell'interfaccia. Questo membro deve avere uno dei valori seguenti:

Valore	Significato
USB_BUSIF_USBDI_VERSION_0	Versione 0 dell'interfaccia.
USB_BUSIF_USBDI_VERSION_1	Versione 1 dell'interfaccia.
USB_BUSIF_USBDI_VERSION_2	Versione 2 dell'interfaccia.
USB_BUSIF_USBDI_VERSION_3	Versione 3 dell'interfaccia.

BusContext

Contiene informazioni che descrivono il bus USB e il driver del bus USB che espone questa interfaccia. Si tratta di un'entità opaca che il chiamante deve passare alle routine dell'interfaccia.

InterfaceReference

Puntatore a una routine che incrementa il numero di riferimenti a questa interfaccia. Per altre informazioni su questa routine, vedere InterfaceReference.

InterfaceDereference

Puntatore a una routine che decrementa il numero di riferimenti a questa interfaccia. Per altre informazioni su questa routine, vedere InterfaceDereference.

GetUSBDIVersion

Puntatore a una routine che restituisce il numero di versione dell'interfaccia USB, il numero di versione della specifica USB che definisce l'interfaccia, insieme alle informazioni sulle funzionalità del controller host. Questa routine restituisce la versione più alta dell'interfaccia USBDI supportata dal driver della porta. Per altre informazioni su questa routine, vedere GetUSBDIVersion.

QueryBusTime

Puntatore a una routine che restituisce il numero di frame USB a 32 bit corrente. Questa routine sostituisce la funzione USBD_QueryBusTime fornita da usbd.sys. Per altre informazioni su questa routine, vedere QueryBusTime.

SubmitIsoOutUrb

Riservato. Non usare.

QueryBusInformation

Puntatore a una routine che restituisce informazioni sul bus. Le informazioni restituite dipendono dal valore del membro livello . Se livello è 0, questa routine restituisce informazioni sulla larghezza di banda del bus. Se livello è 1, restituisce le informazioni sulla larghezza di banda del bus e il nome simbolico del controller host. Questa routine sostituisce la funzione di USBD_QueryBusInformation fornita da usbd.sys. Per altre informazioni su questa routine, vedere QueryBusInformation.

Osservazioni

Per informazioni su come eseguire query per queste interfacce, vedere Querying for USB Interfaces. I chiamanti delle routine in questa struttura possono essere eseguiti in IRQL <= DISPATCH_LEVEL.

Fabbisogno

Requisito	Valore
intestazione	usbbusif.h (include Usbbusif.h)

Vedere anche

routine dell'interfaccia del driver del bus per i driver client USB

strutture USB

Condividi tramite