UsbBuildOpenStaticStreamsRequest-Funktion (usbdlib.h)
Die UsbBuildOpenStaticStreamsRequest Inlinefunktion formatiert eine URB--Struktur für eine Open-Streams-Anforderung. Die Anforderung öffnet Datenströme, 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 für diesen URB-einen nicht seitenfreien Pool zuweisen.
[in] PipeHandle
Ein undurchsichtiges Handle für die dem Endpunkt zugeordnete Pipe, die die zu öffnenden Datenströme enthält.
Der Clienttreiber ruft PipeHandle- aus einer vorherigen Auswahlkonfigurationsanforderung (URB_FUNCTION_SELECT_CONFIGURATION) oder einer Auswahlschnittstellenanforderung (URB_FUNCTION_SELECT_INTERFACE) ab.
[in] NumberOfStreams
Die Anzahl der zu öffnenden Datenströme. Der NumberOfStreams- Wert gibt die Anzahl der Elemente im Array an, auf die durch Streamsverwiesen wird. Dieser Wert muss größer als Null und kleiner als oder gleich der maximalen Anzahl von Datenströmen sein, die von der Hostcontrollerhardware unterstützt werden. Rufen Sie USBD_QueryUsbCapabilityauf, um die maximale Anzahl unterstützter Datenströme abzurufen.
Die Anzahl der Datenströme muss auch kleiner oder gleich der maximalen Anzahl von Datenströmen sein, die vom USB-Gerät unterstützt werden. Um diese Nummer abzurufen, überprüfen Sie den Endpunkt-Begleitdeskriptor.
Geben Sie im NumberOfStreams- Wert weniger von zwei Werten an, die vom Hostcontroller und dem USB-Gerät unterstützt werden.
[in] StreamInfoArray
Zeiger auf ein vom Aufrufer zugewiesenes, initialisiertes Array von USBD_STREAM_INFORMATION Strukturen. Die Länge des Arrays hängt von der Anzahl der zu öffnenden Datenströme ab und muss mit dem wert NumberOfStreams übereinstimmen.
Rückgabewert
Nichts
Bemerkungen
Ein Codebeispiel, das das für eine Open-Streams-Anforderung erforderliche URB-Format zeigt, finden Sie unter Vorgehensweise Öffnen und Schließen statischer Datenströme in einem USB-Massenendpunkt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Erfordert WDK für Windows 8. Zielt auf Windows Vista und höhere Versionen des Windows-Betriebssystems ab. |
| Zielplattform- | Desktop |
| Header- | usbdlib.h |
Siehe auch
Öffnen und Schließen statischer Datenströme in einem USB-Massenendpunkt