WinUsb_RegisterIsochBuffer (winusb.h)

Artikel
03/04/2024

Fungsi WinUsb_RegisterIsochBuffer mendaftarkan buffer yang akan digunakan untuk transfer isochronous.

Sintaks

BOOL WinUsb_RegisterIsochBuffer(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       PipeID,
  [in]  PUCHAR                      Buffer,
  [in]  ULONG                       BufferLength,
  [out] PWINUSB_ISOCH_BUFFER_HANDLE IsochBufferHandle
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka dalam konfigurasi yang dipilih. Handel tersebut harus dibuat oleh panggilan sebelumnya untuk WinUsb_Initialize atau WinUsb_GetAssociatedInterface.

[in] PipeID

Berasal dari Bit 3...0 dari bidang bEndpointAddress di deskriptor titik akhir.

[in] Buffer

Penunjuk ke buffer transfer yang akan didaftarkan.

[in] BufferLength

Panjang, dalam byte, dari buffer transfer yang diacu oleh Buffer.

[out] IsochBufferHandle

Menerima handel buram ke buffer terdaftar. Handel ini diperlukan oleh fungsi WinUSB lainnya yang melakukan transfer isochronous. Untuk merilis handel, panggil fungsi WinUsb_UnregisterIsochBuffer .

Nilai kembali

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

Jika penelepon mengatur ContinueStream ke TRUE, transfer gagal jika Winusb.sys tidak dapat menjadwalkan transfer untuk melanjutkan aliran tanpa menghilangkan satu atau beberapa bingkai.

Keterangan

Sebelum memulai transfer isochronous ke atau dari buffer, pemanggil harus mendaftarkan buffer dengan WinUsb_RegisterIsochBuffer. Panggilan ini memungkinkan Winusb.sys untuk melakukan pra-peta dan mengunci buffer setelah untuk semua transfer berikutnya menggunakan buffer.

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

WinUsb_UnregisterIsochBuffer

Bagikan melalui