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

Статья
02/07/2025

[Применимо к 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-isochronous endpoints.