estructura WDF_USB_PIPE_INFORMATION (wdfusb.h)

Artículo
02/27/2024

[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

El 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 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 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 con tipo WDF_USB_PIPE_TYPE que especifica el tipo de canalización.

MaximumTransferSize

Este miembro no se usa.

Comentarios

El WDF_USB_PIPE_INFORMATION estructura se rellena mediante los métodos WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe y 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 isócronos admitidos en un dispositivo USB, vea Cómo transferir datos a puntos de conexión isocronosos USB.