Fungsi UsbBuildOpenStaticStreamsRequest (usbdlib.h)

  • Artikel

Fungsi sebaris UsbBuildOpenStaticStreamsRequest memformat struktur URB untuk permintaan aliran terbuka. Permintaan membuka aliran yang terkait dengan titik akhir massal yang ditentukan.

Sintaks

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

Parameter

[in, out] Urb

Penunjuk ke struktur URB yang akan diformat untuk permintaan aliran terbuka (URB_FUNCTION_OPEN_STATIC_STREAMS). Penelepon harus mengalokasikan kumpulan yang tidak bertumpuk untuk URB ini.

[in] PipeHandle

Handel buram untuk pipa yang terkait dengan titik akhir yang berisi aliran untuk dibuka.

Driver klien mendapatkan PipeHandle dari permintaan konfigurasi pilih sebelumnya (URB_FUNCTION_SELECT_CONFIGURATION) atau permintaan antarmuka pemilihan (URB_FUNCTION_SELECT_INTERFACE).

[in] NumberOfStreams

Jumlah aliran yang akan dibuka. Nilai NumberOfStreams menunjukkan jumlah elemen dalam array yang ditunjukkan oleh Stream. Nilai ini harus lebih besar dari nol dan kurang dari atau sama dengan jumlah maksimum aliran yang didukung oleh perangkat keras pengontrol host. Untuk mendapatkan jumlah maksimum aliran yang didukung, panggil USBD_QueryUsbCapability.

Jumlah aliran juga harus kurang dari atau sama dengan jumlah maksimum aliran yang didukung oleh perangkat USB. Untuk mendapatkan nomor tersebut, periksa deskriptor pendamping titik akhir.

Dalam nilai NumberOfStreams , tentukan lebih sedikit dari dua nilai yang didukung oleh pengontrol host dan perangkat USB.

[in] StreamInfoArray

Penunjuk ke array struktur USBD_STREAM_INFORMATION yang dialokasikan pemanggil yang dialokasikan. Panjang array tergantung pada jumlah aliran yang akan dibuka dan harus sama dengan nilai NumberOfStreams .

Nilai kembali

Tidak ada

Keterangan

Untuk contoh kode yang menunjukkan format URB yang diperlukan untuk permintaan open-stream, lihat Cara Membuka dan Menutup Aliran Statis di Titik Akhir Massal USB.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Membutuhkan WDK untuk Windows 8. Menargetkan Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform Desktop
Header usbdlib.h

Lihat juga

Cara Membuka dan Menutup Aliran Statis di Titik Akhir Massal USB

_URB_OPEN_STATIC_STREAMS