usbBuildOpenStaticStreamsRequest 函式 (usbdlib.h)
UsbBuildOpenStaticStreamsRequest 內嵌函式會格式化開放數據流要求的 URB 結構。 要求會開啟與指定之大量端點相關聯的數據流。
語法
void UsbBuildOpenStaticStreamsRequest(
[in, out] PURB Urb,
[in] USBD_PIPE_HANDLE PipeHandle,
[in] USHORT NumberOfStreams,
[in] PUSBD_STREAM_INFORMATION StreamInfoArray
);
參數
[in, out] Urb
要針對開放數據流要求 (URB_FUNCTION_OPEN_STATIC_STREAMS) 格式化的 URB 結構的指標。 呼叫端必須為此 URB 配置非分頁集區。
[in] PipeHandle
與端點相關聯的管道不透明句柄,其中包含要開啟的數據流。
用戶端驅動程式會從先前的選取組態要求 (URB_FUNCTION_SELECT_CONFIGURATION) 或選取介面要求 (URB_FUNCTION_SELECT_INTERFACE) 取得 PipeHandle 。
[in] NumberOfStreams
要開啟的數據流數目。 NumberOfStreams 值表示 Streams 所指向之陣列中的元素數目。 此值必須大於零,且小於或等於主機控制器硬體支持的數據流數目上限。 若要取得支持的數據流數目上限,請呼叫 USBD_QueryUsbCapability。
數目數據流也必須小於或等於USB裝置支持的數據流數目上限。 若要取得該數位,請檢查端點隨附描述元。
在 NumberOfStreams 值中,指定主機控制器和 USB 裝置所支援的兩個值小於兩個值。
[in] StreamInfoArray
呼叫端配置的已初始化 USBD_STREAM_INFORMATION 結構的陣列指標。 陣列的長度取決於要開啟的數據流數目,而且必須與 NumberOfStreams 值相同。
傳回值
無
備註
如需顯示開啟數據流要求所需 URB 格式的程式代碼範例,請參閱 如何在 USB 大量端點中開啟和關閉靜態數據流。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 需要 Windows 8的 WDK。 以 Windows Vista 和更新版本的 Windows 作業系統為目標。 |
目標平台 | 桌面 |
標頭 | usbdlib.h |