структура USB_BUS_INTERFACE_USBDI_V2 (usbbusif.h)

  • Статья

Структура USB_BUS_INTERFACE_USBDI_V2 предоставляется драйвером КОНЦЕНТРАТОРа USB, чтобы позволить USB-клиентам совершать прямые вызовы к драйверу концентратора без выделения IRP.

Синтаксис

typedef struct _USB_BUS_INTERFACE_USBDI_V2 {
  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;
  PUSB_BUSIFFN_ENUM_LOG_ENTRY        EnumLogEntry;
} USB_BUS_INTERFACE_USBDI_V2, *PUSB_BUS_INTERFACE_USBDI_V2;

Члены

Size

Задает размер в байтах буфера, в котором содержатся указатели интерфейса.

Version

Указывает на входные данные версию интерфейса. Ниже приведены значения, которые может принимать этот элемент.

Значение Значение
USB_BUSIF_USBDI_VERSION_0 Версия 0 интерфейса.
USB_BUSIF_USBDI_VERSION_1 Версия 1 интерфейса.
USB_BUSIF_USBDI_VERSION_2 Версия 2 интерфейса.
USB_BUSIF_USBDI_VERSION_3 Версия 3 интерфейса.

BusContext

Содержит сведения, описывающие USB-шину и драйвер шины USB, который предоставляет этот интерфейс. Это непрозрачная сущность, которую вызывающий объект должен передать подпрограммам интерфейса.

InterfaceReference

Указатель на подпрограмму, которая увеличивает количество ссылок на этот интерфейс. Дополнительные сведения об этой подпрограмме см. в разделе InterfaceReference.

InterfaceDereference

Указатель на подпрограмму, которая уменьшает количество ссылок на этот интерфейс. Дополнительные сведения об этой подпрограмме см. в разделе InterfaceDereference.

GetUSBDIVersion

Указатель на подпрограмму, которая возвращает номер версии интерфейса USB, номер версии спецификации USB, определяющей интерфейс, а также сведения о возможностях контроллера узла. Эта подпрограмма возвращает самую высокую версию интерфейса USBDI, поддерживаемую драйвером порта. Дополнительные сведения об этой подпрограмме см. в разделе GetUSBDIVersion.

QueryBusTime

Указатель на подпрограмму, которая возвращает текущий 32-разрядный номер кадра USB. Эта подпрограмма заменяет функцию USBD_QueryBusTime , предоставляемую usbd.sys. Дополнительные сведения об этой подпрограмме см. в разделе QueryBusTime.

SubmitIsoOutUrb

Зарезервировано. Не используется.

QueryBusInformation

Указатель на подпрограмму, которая получает сведения о шине. Возвращаемые сведения зависят от значения элемента Level . Если уровень равен 0, эта подпрограмма возвращает сведения о пропускной способности шины. Если уровень равен 1, он возвращает сведения о пропускной способности шины и символьное имя контроллера узла. Эта подпрограмма заменяет функцию USBD_QueryBusInformation , предоставляемую usbd.sys. Дополнительные сведения об этой подпрограмме см. в разделе QueryBusInformation.

IsDeviceHighSpeed

Указатель на подпрограмму, которая определяет, работает ли USB-устройство на высокой скорости. Эта подпрограмма возвращает значение TRUE , если USB-устройство работает на высокоскоростных устройствах, совместимых с USB 2.0. В противном случае возвращает значение FALSE . Дополнительные сведения об этой подпрограмме см. в разделе IsDeviceHighSpeed.

EnumLogEntry

Зарезервировано. Не используется.

Комментарии

Подпрограмма IsDeviceHighSpeed не указывает, может ли устройство работать на высокой скорости, но действительно ли оно работает на высокой скорости.

Подпрограммы в этой структуре должны вызываться в IRQL >= DISPATCH_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версий.
Верхняя часть usbbusif.h (включая Usbbusif.h)

См. также раздел

Подпрограммы интерфейса драйвера шины для драйверов USB-клиента

Структуры USB