Función UsbBuildOpenStaticStreamsRequest (usbdlib.h)

Artículo
02/29/2024

La función insertada UsbBuildOpenStaticStreamsRequest da formato a una estructura URB para una solicitud de flujos abiertos. La solicitud abre secuencias asociadas al punto de conexión masivo especificado.

Sintaxis

void UsbBuildOpenStaticStreamsRequest(
  [in, out] PURB                     Urb,
  [in]      USBD_PIPE_HANDLE         PipeHandle,
  [in]      USHORT                   NumberOfStreams,
  [in]      PUSBD_STREAM_INFORMATION StreamInfoArray
);

Parámetros

[in, out] Urb

Puntero a la estructura URB que se va a dar formato a la solicitud de flujo abierto (URB_FUNCTION_OPEN_STATIC_STREAMS). El autor de la llamada debe asignar un grupo no paginado para este URB.

[in] PipeHandle

Identificador opaco de la canalización asociada al punto de conexión que contiene las secuencias que se van a abrir.

El controlador cliente obtiene PipeHandle de una solicitud de configuración de selección anterior (URB_FUNCTION_SELECT_CONFIGURATION) o una solicitud select-interface (URB_FUNCTION_SELECT_INTERFACE).

[in] NumberOfStreams

Número de secuencias que se van a abrir. El valor NumberOfStreams indica el número de elementos de la matriz a la que apunta Streams. Este valor debe ser mayor que cero y menor o igual que el número máximo de secuencias admitidas por el hardware del controlador de host. Para obtener el número máximo de flujos admitidos, llame a USBD_QueryUsbCapability.

Los flujos numéricos también deben ser menores o iguales que el número máximo de secuencias compatibles con el dispositivo USB. Para obtener ese número, inspeccione el descriptor complementario del punto de conexión.

En el valor NumberOfStreams , especifique un menor de dos valores admitidos por el controlador de host y el dispositivo USB.

[in] StreamInfoArray

Puntero a una matriz asignada por el autor de la llamada de estructuras de USBD_STREAM_INFORMATION inicializadas. La longitud de la matriz depende del número de secuencias que se van a abrir y debe ser la misma que el valor NumberOfStreams .

Valor devuelto

None

Observaciones

Para obtener un ejemplo de código que muestre el formato URB necesario para una solicitud de flujos abiertos, vea Cómo abrir y cerrar secuencias estáticas en un punto de conexión masivo USB.

Requisitos

Requisito	Value
Cliente mínimo compatible	Requiere WDK para Windows 8. Tiene como destino Windows Vista y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Escritorio
Encabezado	usbdlib.h

Consulte también

Cómo abrir y cerrar secuencias estáticas en un punto de conexión masivo USB

_URB_OPEN_STATIC_STREAMS

Share via