estructura WDF_USB_PIPE_INFORMATION (wdfusb.h)

Artículo
02/07/2025

[Se aplica a KMDF y UMDF]

La estructura WDF_USB_PIPE_INFORMATION contiene información sobre una canalización USB y su punto de conexión.

Sintaxis

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;

Miembros

Size

Tamaño, en bytes, de esta estructura.

MaximumPacketSize

Tamaño máximo de paquete, en bytes, que el punto de conexión de la canalización es capaz de enviar o recibir.

En el caso de los puntos de conexión isócronos de alta velocidad, el valor de MaximumPacketSize recibido incluye el número de bytes que se pueden transferir en transacciones adicionales, si el punto de conexión los admite.

EndpointAddress

Dirección del punto de conexión en el dispositivo USB. Para obtener más información sobre las direcciones de punto de conexión, consulte la especificación USB.

Interval

El intervalo de sondeo del punto de conexión, si el miembro pipeType de está establecido en WdfUsbPipeTypeInterrupt. Para obtener más información sobre los intervalos de sondeo, consulte la especificación USB.

SettingIndex

Valor de índice que identifica la configuración alternativa, dentro de una interfaz, a la que pertenece la canalización. Para obtener más información sobre la configuración alternativa, consulte la especificación USB.

PipeType

Valor WDF_USB_PIPE_TYPEcon tipo que especifica el tipo de canalización.

MaximumTransferSize

Este miembro no se usa.

Observaciones

La estructura WDF_USB_PIPE_INFORMATION se rellena mediante el WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipey métodos WdfUsbInterfaceGetEndpointInformation.

Para inicializar una estructura de WDF_USB_PIPE_INFORMATION, el controlador debe llamar a WDF_USB_PIPE_INFORMATION_INIT.

Para obtener más información sobre el miembro MaximumPacketSize de esta estructura, vea la sección Comentarios de USBD_PIPE_INFORMATION.

Para obtener información sobre cómo transferir datos hacia y desde puntos de conexión isocrónicos admitidos en un dispositivo USB, consulte Cómo transferir datos a puntos de conexión isocrónicos USB.