fungsi WinUsb_WriteIsochPipe (winusb.h)

Artikel
08/27/2023

Fungsi WinUsb_WriteIsochPipe menulis konten buffer yang disediakan penelepon ke titik akhir OUT isochronous, dimulai pada nomor bingkai tertentu.

Sintaks

BOOL WinUsb_WriteIsochPipe(
  [in]           WINUSB_ISOCH_BUFFER_HANDLE BufferHandle,
  [in]           ULONG                      Offset,
  [in]           ULONG                      Length,
  [in, out]      PULONG                     FrameNumber,
  [in, optional] LPOVERLAPPED               Overlapped
);

Parameter

[in] BufferHandle

Handel buram ke buffer transfer yang didaftarkan oleh panggilan sebelumnya ke WinUsb_RegisterIsochBuffer.

[in] Offset

Offset ke dalam buffer relatif terhadap mulai transfer.

[in] Length

Panjang dalam byte buffer transfer.

[in, out] FrameNumber

Pada input, menunjukkan nomor bingkai awal untuk transfer. Pada output, berisi nomor bingkai bingkai yang mengikuti bingkai terakhir yang digunakan dalam transfer.

[in, optional] Overlapped

Penunjuk ke struktur TUMPANG TINDIH yang digunakan untuk operasi asinkron.

Nilai kembali

WinUsb_WriteIsochPipe mengembalikan TRUE jika operasi berhasil. Jika tidak, fungsi ini mengembalikan FALSE, dan pemanggil dapat mengambil kesalahan yang dicatat dengan memanggil GetLastError.

Keterangan

WinUsb_WriteIsochPipe mengemas buffer transfer sehingga dalam setiap interval 1ms, host dapat mengirim byte maksimum yang diizinkan per interval. Byte maksimum seperti yang ditentukan oleh deskriptor titik akhir untuk titik akhir penuh dan berkecepatan tinggi, dan deskriptor pendamping titik akhir untuk titik akhir SuperSpeed. Jika pemanggil mengirimkan beberapa permintaan tulis untuk mengalirkan data ke perangkat, ukuran transfer harus menjadi kelipatan byte maksimum per interval (seperti yang dikembalikan oleh WinUsb_QueryPipeEx) * 8 / interval.

Karena kemasan transfer yang digunakan dalam antarmuka mode kernel yang mendasar, pemberitahuan latensi terendah ke aplikasi atau driver adalah interval 1ms.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Server minimum yang didukung	Windows Server 2012 R2
Target Platform	Universal
Header	winusb.h (termasuk Winusb.h)
Pustaka	Winusb.lib
DLL	Winusb.dll

Lihat juga

Mengirim transfer isochronous USB dari aplikasi desktop WinUSB

Fungsi WinUSB

Bagikan melalui