USB_BUS_INTERFACE_USBDI_V0 struttura (usbbusif.h)

Articolo
03/05/2024

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 indirizzi IP.

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;

Members

Size

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

Version

Indica, in 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 di 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 decredisce 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 dell'interfaccia USBDI più elevata supportata dal driver di 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 Level . Se il livello è 0, questa routine restituisce informazioni sulla larghezza di banda del bus. Se il livello è 1, restituisce informazioni sulla larghezza di banda del bus e il nome simbolico del controller host. Questa routine sostituisce la funzione USBD_QueryBusInformation fornita da usbd.sys. Per altre informazioni su questa routine, vedere QueryBusInformation.

Commenti

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

Requisiti

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

Vedi anche

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

Strutture USB

Condividi tramite