UsbBuildOpenStaticStreamsRequest, fonction (usbdlib.h)

Article
02/07/2025

Le UsbBuildOpenStaticStreamsRequest fonction inline met en forme une structure URB pour une requête open-streams. La requête ouvre des flux associés au point de terminaison en bloc spécifié.

Syntaxe

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

Paramètres

[in, out] Urb

Pointeur vers la structure URB à mettre en forme pour la requête open-stream (URB_FUNCTION_OPEN_STATIC_STREAMS). L’appelant doit allouer un pool non paginé pour ce URB.

[in] PipeHandle

Handle opaque pour le canal associé au point de terminaison qui contient les flux à ouvrir.

Le pilote client obtient PipeHandle à partir d’une demande de configuration de sélection précédente (URB_FUNCTION_SELECT_CONFIGURATION) ou d’une demande d’interface de sélection (URB_FUNCTION_SELECT_INTERFACE).

[in] NumberOfStreams

Nombre de flux à ouvrir. La valeur NumberOfStreams indique le nombre d’éléments dans le tableau pointé par Streams. Cette valeur doit être supérieure à zéro et inférieure ou égale au nombre maximal de flux pris en charge par le matériel du contrôleur hôte. Pour obtenir le nombre maximal de flux pris en charge, appelez USBD_QueryUsbCapability.

Le nombre de flux doit également être inférieur ou égal au nombre maximal de flux pris en charge par l’appareil USB. Pour obtenir ce numéro, inspectez le descripteur complémentaire du point de terminaison.

Dans le NumberOfStreams valeur, spécifiez une valeur inférieure de deux valeurs prises en charge par le contrôleur hôte et le périphérique USB.

[in] StreamInfoArray

Pointeur vers un tableau alloué par l’appelant et initialisé de structures USBD_STREAM_INFORMATION. La longueur du tableau dépend du nombre de flux à ouvrir et doit être identique à la valeur NumberOfStreams.

Valeur de retour

Aucun

Remarques

Pour obtenir un exemple de code qui montre le format URB requis pour une requête open-streams, consultez Comment ouvrir et fermer des flux statiques dans un point de terminaison en bloc USB.

Exigences

Exigence	Valeur
client minimum pris en charge	Nécessite WDK pour Windows 8. Cible Windows Vista et les versions ultérieures du système d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	usbdlib.h

Voir aussi

Comment ouvrir et fermer des flux statiques dans un point de terminaison en bloc USB

_URB_OPEN_STATIC_STREAMS

Partager via