UsbBuildOpenStaticStreamsRequest-Funktion (usbdlib.h)
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