_URB_OPEN_STATIC_STREAMS Struktur (usb.h)

Artikel
02/29/2024

Die _URB_OPEN_STATIC_STREAMS-Struktur wird von einem USB-Clienttreiber verwendet, um Streams im angegebenen Massenendpunkt zu öffnen.

Um die URB zu formatieren, rufen Sie die UsbBuildOpenStaticStreamsRequest-Funktion auf.

Syntax

struct _URB_OPEN_STATIC_STREAMS {
  struct _URB_HEADER       Hdr;
  USBD_PIPE_HANDLE         PipeHandle;
  ULONG                    NumberOfStreams;
  USHORT                   StreamInfoVersion;
  USHORT                   StreamInfoSize;
  PUSBD_STREAM_INFORMATION Streams;
};

Member

Hdr

Die _URB_HEADER-Struktur , die die URB-Headerinformationen angibt. Hdr.Function muss URB_FUNCTION_OPEN_STATIC_STREAMS sein, und Hdr.Length muss sein sizeof(_URB_OPEN_STATIC_STREAMS).

PipeHandle

Ein undurchsichtiges Handle für die Pipe, die dem Endpunkt zugeordnet ist, der das Öffnen der Streams unterstützt.

Der Clienttreiber ruft PipeHandle aus der URB_FUNCTION_SELECT_CONFIGURATION- oder URB_FUNCTION_SELECT_INTERFACE-Anforderung ab.

NumberOfStreams

Die Anzahl der zu öffnenden Streams. Der NumberOfStreams-Wert gibt die Anzahl der Elemente im Array an, auf die von Streams verwiesen wird. Dieser Wert muss größer als 0 und kleiner als oder gleich der maximalen Anzahl von Streams sein, die vom USB-Treiberstapel, dem Hostcontroller und dem Endpunkt im Gerät unterstützt werden. Weitere Informationen finden Sie in den Hinweisen.

StreamInfoVersion

Version der USBD_STREAM_INFORMATION-Struktur . Muss auf URB_OPEN_STATIC_STREAMS_VERSION_100 festgelegt werden. Andernfalls schlägt die Anforderung fehl, und die URB-status wird USBD_STATUS_INVALID_PARAMETER.

StreamInfoSize

Größe der USBD_STREAM_INFORMATION Struktur. StreamInfoSize muss seinsizeof(USBD_STREAM_INFORMATION). Andernfalls schlägt die Anforderung fehl, und die URB-status wird USBD_STATUS_INFO_LENGTH_MISMATCH.

Streams

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 Streams ab und muss mit dem NumberOfStreams-Wert identisch sein. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Um Datenströme (außer dem Standardstream) im Endpunkt für E/A-Vorgänge zu verwenden, öffnet der Clienttreiber die erforderlichen Datenströme, indem er eine Open-Stream-Anforderung (URB_FUNCTION_OPEN_STATIC_STREAMS) an den USB-Treiberstapel sendet. Für die Anforderung muss der Clienttreiber die URB formatieren, indem er die _URB_OPEN_STATIC_STREAMS-Struktur initialisiert. Um die URB zu formatieren, rufen Sie die UsbBuildOpenStaticStreamsRequest-Funktion auf.

Die maximale Anzahl von Streams, die von einem Clienttreiber geöffnet werden können, muss kleiner oder gleich der maximalen Anzahl von Streams sein, die vom USB-Treiberstapel, dem Hostcontroller und dem Massenendpunkt unterstützt werden. Um die maximale Anzahl von Streams abzurufen, die vom Hostcontroller unterstützt werden, rufen Sie USBD_QueryUsbCapability auf. Der USB-Treiberstapel unterstützt bis zu 255 Streams. Wenn der Clienttreiber mehr als 255 Streams anfordert, schlägt USBD_QueryUsbCapability die Anforderung fehl. Um die maximale Anzahl von Streams abzurufen, die vom Endpunkt unterstützt werden, überprüfen Sie den Endpunkt-Begleitdeskriptor (siehe USB_SUPERSPEED_ENDPOINT_COMPANION_DESCRIPTOR in Usbspec.h).

Informationen zum Formatieren der URB für die Open-Stream-Anforderung und das Codebeispiel finden Sie unter Öffnen und Schließen statischer Streams in einem USB-Massenendpunkt.

Wenn der Clienttreiber die Datenströme verwendet hat, kann der Treiber alle Streams schließen, die einem bestimmten Endpunkt zugeordnet sind, indem er eine Close-Stream-Anforderung sendet. Um die Anforderung zu senden, muss der Clienttreiber Informationen zum Endpunkt in der _URB_PIPE_REQUEST-Struktur angeben. Das Hdr-Element von _URB_PIPE_REQUEST muss URB_FUNCTION_CLOSE_STATIC_STREAMS sein. Das PipeHandle-Element muss das Handle für den Endpunkt sein, der die verwendeten Streams enthält.