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

Статья
02/07/2025

Структура USB_BUS_INTERFACE_USBDI_V0 предоставляется драйвером USB-концентратора, чтобы позволить USB-клиентам выполнять прямые вызовы к драйверу концентратора без выделения ip-адресов.

Синтаксис

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;

Члены

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

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

Замечания

Сведения о том, как запрашивать эти интерфейсы, см. в запросах для USB-интерфейсов. Вызывающие процедуры в этой структуре могут выполняться в IRQL <= DISPATCH_LEVEL.

Требования

Требование	Ценность
заголовка	usbbusif.h (include Usbbusif.h)

См. также

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

СТРУКТУРЫ USB

Поделиться через