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


структура WDF_USB_PIPE_INFORMATION (wdfusb.h)

[Относится к KMDF и UMDF]

Структура WDF_USB_PIPE_INFORMATION содержит сведения о USB-канале и его конечной точке.

Синтаксис

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

Члены

Size

Размер данной структуры (в байтах).

MaximumPacketSize

Максимальный размер пакета (в байтах), который конечная точка канала может отправлять или получать.

Для высокоскоростных изохронных конечных точек полученное значение MaximumPacketSize включает количество байтов, которые могут быть переданы в дополнительных транзакциях, если конечная точка поддерживает их.

EndpointAddress

Адрес конечной точки на USB-устройстве. Дополнительные сведения об адресах конечных точек см. в спецификации USB.

Interval

Интервал опроса конечной точки, если для элемента PipeType задано значение WdfUsbPipeTypeInterrupt. Дополнительные сведения о интервалах опроса см. в спецификации USB.

SettingIndex

Значение индекса, определяющее альтернативный параметр в интерфейсе, к которому принадлежит канал. Дополнительные сведения об альтернативных параметрах см. в спецификации USB.

PipeType

WDF_USB_PIPE_TYPE типизированное значение, указывающее тип канала.

MaximumTransferSize

Этот элемент не используется.

Комментарии

Структура WDF_USB_PIPE_INFORMATION заполняется методами WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe и WdfUsbInterfaceGetEndpointInformation .

Чтобы инициализировать структуру WDF_USB_PIPE_INFORMATION , драйвер должен вызвать WDF_USB_PIPE_INFORMATION_INIT.

Дополнительные сведения об элементе MaximumPacketSize этой структуры см. в разделе Примечания USBD_PIPE_INFORMATION.

Сведения о передаче данных в поддерживаемые изохронные конечные точки на USB-устройстве и из нее см. в статье Передача данных в изохронные конечные точки USB.

Требования

Требование Значение
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfusb.h (включая Wdfusb.h)

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

USBD_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WDF_USB_PIPE_TYPE

WdfUsbInterfaceGetConfiguredPipe

WdfUsbInterfaceGetEndpointInformation

WdfUsbTargetPipeGetInformation