UsbBuildOpenStaticStreamsRequest-Funktion (usbdlib.h)

  • Artikel

Die Inlinefunktion UsbBuildOpenStaticStreamsRequest formatiert eine URB-Struktur für eine Open-Streams-Anforderung. Die Anforderung öffnet Streams, die dem angegebenen Massenendpunkt zugeordnet sind.

Syntax

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

Parameter

[in, out] Urb

Zeiger auf die URB-Struktur , die für die Open-Stream-Anforderung (URB_FUNCTION_OPEN_STATIC_STREAMS) formatiert werden soll. Der Aufrufer muss einen nicht auslagerten Pool für diese URB zuordnen.

[in] PipeHandle

Ein undurchsichtiges Handle für die Pipe, die dem Endpunkt zugeordnet ist, der die zu öffnenden Streams enthält.

Der Clienttreiber ruft PipeHandle aus einer vorherigen Select-Configuration-Anforderung (URB_FUNCTION_SELECT_CONFIGURATION) oder einer Select-Interface-Anforderung (URB_FUNCTION_SELECT_INTERFACE) ab.

[in] NumberOfStreams

Die Anzahl der zu öffnenden Streams. Der NumberOfStreams-Wert gibt die Anzahl der Elemente im Array an, auf die streams verweist. Dieser Wert muss größer als 0 (null) und kleiner oder gleich der maximalen Anzahl von Streams sein, die von der Hostcontrollerhardware unterstützt werden. Rufen Sie USBD_QueryUsbCapability auf, um die maximale Anzahl unterstützter Streams abzurufen.

Die Anzahl der Streams muss auch kleiner oder gleich der maximalen Anzahl von Streams sein, die vom USB-Gerät unterstützt werden. Um diese Nummer zu erhalten, überprüfen Sie den Endpunkt-Begleitdeskriptor.

Geben Sie im Wert NumberOfStreams weniger von zwei Werten an, die vom Hostcontroller und dem USB-Gerät unterstützt werden.

[in] StreamInfoArray

Zeiger auf ein vom Aufrufer zugeordnetes, initialisiertes Array von USBD_STREAM_INFORMATION Strukturen. Die Länge des Arrays hängt von der Anzahl der zu öffnenden Streams ab und muss mit dem NumberOfStreams-Wert übereinstimmen.

Rückgabewert

Keine

Bemerkungen

Ein Codebeispiel, das das für eine Open-Streams-Anforderung erforderliche URB-Format zeigt, finden Sie unter Öffnen und Schließen statischer Datenströme in einem USB-Massenendpunkt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Erfordert WDK für Windows 8. Zielt auf Windows Vista und höhere Versionen des Windows-Betriebssystems ab.
Zielplattform Desktop
Kopfzeile usbdlib.h

Weitere Informationen

Öffnen und Schließen statischer Datenströme in einem USB-Massenendpunkt

_URB_OPEN_STATIC_STREAMS