structure USB_BUS_INTERFACE_USBDI_V1 (usbbusif.h)

  • Article

La structure de USB_BUS_INTERFACE_USBDI_V1 est fournie par le pilote du hub USB pour permettre aux clients USB d’effectuer des appels directs au pilote du hub sans allouer d’IRPs.

Syntaxe

typedef struct _USB_BUS_INTERFACE_USBDI_V1 {
  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;
  PUSB_BUSIFFN_IS_DEVICE_HIGH_SPEED  IsDeviceHighSpeed;
} USB_BUS_INTERFACE_USBDI_V1, *PUSB_BUS_INTERFACE_USBDI_V1;

Membres

Size

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

Version

Indique, en entrée, la version de l’interface. Les valeurs que ce membre peut prendre sont les 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 exposent 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 d’interface USBDI la plus élevée 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 trame 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 récupère 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 les informations de bande passante du bus. Si Level a la valeur 1, il retourne les informations de 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.

IsDeviceHighSpeed

Pointeur vers une routine qui détermine si le périphérique USB fonctionne à grande vitesse. Cette routine retourne TRUE si le périphérique USB fonctionne à grande vitesse (appareil compatible USB 2.0). Sinon, cette routine retourne FALSE. Pour plus d’informations sur cette routine, consultez IsDeviceHighSpeed.

Remarques

Le membre IsDeviceHighSpeed n’indique pas si un appareil est capable de fonctionner à haute vitesse, mais plutôt s’il fonctionne à grande vitesse.

Les routines de cette structure doivent être appelées dans IRQL >= DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs.
En-tête usbbusif.h (inclure Usbbusif.h)

Voir aussi

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

USB Structures