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

  • Статья

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

Синтаксис

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

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

Комментарии

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

Требования

Требование Значение
Заголовок usbbusif.h (включая Usbbusif.h)

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

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

Структуры USB