USB_BUS_INTERFACE_USBDI_V1 structure (usbbusif.h)

The USB_BUS_INTERFACE_USBDI_V1 structure is provided by the USB hub driver to allow USB clients to make direct calls to the hub driver without allocating IRPs.

Syntax

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;

Members

Size

Specifies the size in bytes of the buffer that holds the interface pointers.

Version

Indicates, on input, the version of the interface. The values that this member can take are as follows.

Value Meaning
USB_BUSIF_USBDI_VERSION_0 Version 0 of the interface.
USB_BUSIF_USBDI_VERSION_1 Version 1 of the interface.
USB_BUSIF_USBDI_VERSION_2 Version 2 of the interface.
USB_BUSIF_USBDI_VERSION_3 Version 3 of the interface.

BusContext

Contains information that describes the USB bus and the USB bus driver that exposes this interface. This is an opaque entity that the caller must pass to the interface routines.

InterfaceReference

Pointer to a routine that increments the number of references to this interface. For more information about this routine, see InterfaceReference.

InterfaceDereference

Pointer to a routine that decrements the number of references to this interface. For more information about this routine, see InterfaceDereference.

GetUSBDIVersion

Pointer to a routine that returns the USB interface version number, the version number of USB specification that defines the interface, along with host controller capabilities information. This routine returns the highest USBDI interface version supported by the port driver. For more information about this routine, see GetUSBDIVersion.

QueryBusTime

Pointer to a routine that returns the current 32-bit USB frame number. This routine replaces the USBD_QueryBusTime function provided by usbd.sys. For more information about this routine, see QueryBusTime.

SubmitIsoOutUrb

Reserved. Do not use.

QueryBusInformation

Pointer to a routine that retrieves information about the bus. The information that is returned depends on the value of the Level member. If Level is 0, this routine returns bus bandwidth information. If Level is 1, it returns bus bandwidth information and the host controller's symbolic name. This routine replaces the USBD_QueryBusInformation function provided by usbd.sys. For more information about this routine, see QueryBusInformation.

IsDeviceHighSpeed

Pointer to a routine that determines whether the USB device is operating at high speed. This routine returns TRUE if the USB device is operating at high speed (USB 2.0-compliant device). Otherwise this routine returns FALSE. For more information about this routine, see IsDeviceHighSpeed.

Remarks

The IsDeviceHighSpeed member does not indicate whether a device is capable of high speed operation, but rather whether it is in fact operating at high speed.

The routines in this structure must be callable at IRQL >= DISPATCH_LEVEL.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems.
Header usbbusif.h (include Usbbusif.h)

See also

Bus Driver Interface Routines for USB Client Drivers

USB Structures