Funzione UsbBuildOpenStaticStreamsRequest (usbdlib.h)

Articolo
02/29/2024

La funzione inline UsbBuildOpenStaticStreamsRequest formatta una struttura CSV per una richiesta open-streams. La richiesta apre flussi associati all'endpoint bulk specificato.

Sintassi

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

Parametri

[in, out] Urb

Puntatore alla struttura DELL'OGGETTO da formattare per la richiesta open stream (URB_FUNCTION_OPEN_STATIC_STREAMS). Il chiamante deve allocare un pool non di paging per questo ELEMENTO.

[in] PipeHandle

Handle opaco per la pipe associata all'endpoint che contiene i flussi da aprire.

Il driver client ottiene PipeHandle da una richiesta di configurazione select-configuration precedente (URB_FUNCTION_SELECT_CONFIGURATION) o una richiesta di interfaccia select (URB_FUNCTION_SELECT_INTERFACE).

[in] NumberOfStreams

Numero di flussi da aprire. Il valore NumberOfStreams indica il numero di elementi nella matrice a cui punta Streams. Questo valore deve essere maggiore di zero e minore o uguale al numero massimo di flussi supportati dall'hardware del controller host. Per ottenere il numero massimo di flussi supportati, chiamare USBD_QueryUsbCapability.

I flussi numerici devono anche essere minori o uguali al numero massimo di flussi supportati dal dispositivo USB. Per ottenere tale numero, esaminare il descrittore complementare dell'endpoint.

Nel valore NumberOfStreams specificare un valore minore di due valori supportati dal controller host e dal dispositivo USB.

[in] StreamInfoArray

Puntatore a una matrice allocata dal chiamante e inizializzata di strutture USBD_STREAM_INFORMATION . La lunghezza della matrice dipende dal numero di flussi da aprire e deve essere uguale al valore NumberOfStreams .

Valore restituito

nessuno

Osservazioni

Per un esempio di codice che mostra il formato DELL'OGGETTO RICHIESTO per una richiesta open-streams, vedere Come aprire e chiudere flussi statici in un endpoint bulk USB.

Requisiti

Requisito	Valore
Client minimo supportato	Richiede WDK per Windows 8. È destinato a Windows Vista e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Desktop
Intestazione	usbdlib.h

Vedi anche

Come aprire e chiudere flussi statici in un endpoint bulk USB

_URB_OPEN_STATIC_STREAMS

Condividi tramite