структура 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) |
См. также раздел
WdfUsbInterfaceGetConfiguredPipe