structure USB_BUS_INTERFACE_USBDI_V0 (usbbusif.h)

Article
02/26/2024

La structure USB_BUS_INTERFACE_USBDI_V0 est fournie par le pilote de hub USB pour permettre aux clients USB d’effectuer des appels directs vers le pilote de hub sans allouer des irps.

Syntaxe

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;

Membres

Size

Spécifie la taille en octets de la mémoire tampon qui contient les pointeurs d’interface.

Version

Indique, lors de l’entrée, la version de l’interface. Ce membre doit avoir l’une des valeurs suivantes :

Valeur	Signification
USB_BUSIF_USBDI_VERSION_0	Version 0 de l’interface.
USB_BUSIF_USBDI_VERSION_1	Version 1 de l’interface.
USB_BUSIF_USBDI_VERSION_2	Version 2 de l’interface.
USB_BUSIF_USBDI_VERSION_3	Version 3 de l’interface.

BusContext

Contient des informations qui décrivent le bus USB et le pilote de bus USB qui expose cette interface. Il s’agit d’une entité opaque que l’appelant doit passer aux routines d’interface.

InterfaceReference

Pointeur vers une routine qui incrémente le nombre de références à cette interface. Pour plus d’informations sur cette routine, consultez InterfaceReference.

InterfaceDereference

Pointeur vers une routine qui décrémente le nombre de références à cette interface. Pour plus d’informations sur cette routine, consultez InterfaceDereference.

GetUSBDIVersion

Pointeur vers une routine qui retourne le numéro de version de l’interface USB, le numéro de version de la spécification USB qui définit l’interface, ainsi que les informations sur les fonctionnalités du contrôleur hôte. Cette routine retourne la version la plus élevée de l’interface USBDI prise en charge par le pilote de port. Pour plus d’informations sur cette routine, consultez GetUSBDIVersion.

QueryBusTime

Pointeur vers une routine qui retourne le numéro de cadre USB 32 bits actuel. Cette routine remplace la fonction USBD_QueryBusTime fournie par usbd.sys. Pour plus d’informations sur cette routine, consultez QueryBusTime.

SubmitIsoOutUrb

Réservé. Ne pas utiliser.

QueryBusInformation

Pointeur vers une routine qui retourne des informations sur le bus. Les informations retournées dépendent de la valeur du membre Level . Si Level a la valeur 0, cette routine retourne des informations sur la bande passante du bus. Si Level a la valeur 1, il retourne des informations sur la bande passante du bus et le nom symbolique du contrôleur hôte. Cette routine remplace la fonction USBD_QueryBusInformation fournie par usbd.sys. Pour plus d’informations sur cette routine, consultez QueryBusInformation.

Remarques

Pour plus d’informations sur la façon d’interroger ces interfaces, consultez Interrogation des interfaces USB. Les appelants des routines de cette structure peuvent s’exécuter sur IRQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise	Valeur
En-tête	usbbusif.h (inclure Usbbusif.h)

Voir aussi

Routines d’interface de pilote de bus pour les pilotes clients USB

USB Structures

Partager via