PFN_WSK_SEND_BACKLOG_EVENT fungsi panggilan balik (wsk.h)

Artikel
08/08/2023

Fungsi panggilan balik peristiwa WskSendBacklogEvent memberi tahu aplikasi WSK ketika ukuran backlog pengiriman ideal berubah untuk soket berorientasi koneksi.

Sintaks

PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;

NTSTATUS PfnWskSendBacklogEvent(
  [in, optional] PVOID SocketContext,
  [in]           SIZE_T IdealBacklogSize
)
{...}

Parameter

[in, optional] SocketContext

Penunjuk ke konteks soket untuk soket berorientasi koneksi yang memberi tahu aplikasi WSK tentang perubahan pada ukuran backlog pengiriman yang ideal. Aplikasi WSK menyediakan pointer ini ke subsistem WSK dengan salah satu cara berikut:

Ini disebut fungsi WskSocket untuk membuat soket.
Ini disebut fungsi WskSocketConnect untuk membuat soket.
Ini memanggil fungsi WskAccept untuk menerima soket sebagai koneksi masuk.
Fungsi panggilan balik peristiwa WskAcceptEvent dipanggil untuk menerima soket sebagai koneksi masuk.

[in] IdealBacklogSize

Variabel yang berisi ukuran backlog kirim ideal baru.

Nilai kembali

Fungsi panggilan balik peristiwa WskSendBacklogEvent aplikasi WSK harus selalu mengembalikan STATUS_SUCCESS.

Keterangan

Subsistem WSK memanggil fungsi panggilan balik peristiwa WskSendBacklogEvent aplikasi WSK ketika ideal mengirim perubahan ukuran backlog untuk soket berorientasi koneksi hanya jika fungsi panggilan balik peristiwa sebelumnya diaktifkan dengan opsi soket SO_WSK_EVENT_CALLBACK . Untuk informasi selengkapnya tentang mengaktifkan fungsi panggilan balik peristiwa soket, lihat Mengaktifkan dan Menonaktifkan Fungsi Panggilan Balik Peristiwa.

Ukuran backlog pengiriman yang ideal untuk soket berorientasi koneksi adalah jumlah optimal data pengiriman yang perlu dijaga tetap luar biasa (yaitu, diteruskan ke subsistem WSK tetapi belum selesai) untuk menjaga aliran data soket tetap penuh setiap saat. Aplikasi WSK dapat menggunakan ukuran ini untuk melakukan pemeriksaan secara bertahap dan mengunci buffer data yang akan dikirim berdasarkan status kontrol aliran koneksi yang mendasar.

Aplikasi WSK dapat memperoleh ukuran backlog ideal saat ini untuk soket berorientasi koneksi kapan saja dengan memanggil fungsi WskControlSocket .

Subsistem WSK memanggil fungsi panggilan balik kejadian WskSendBacklogEvent aplikasi WSK di IRQL <= DISPATCH_LEVEL.

Fungsi panggilan balik peristiwa WskSendBacklogEvent aplikasi WSK tidak boleh menunggu penyelesaian permintaan WSK lainnya dalam konteks penyelesaian WSK atau fungsi panggilan balik peristiwa. Panggilan balik dapat memulai permintaan WSK lainnya (dengan asumsi bahwa panggilan balik tidak menghabiskan terlalu banyak waktu pada DISPATCH_LEVEL), tetapi tidak boleh menunggu penyelesaiannya bahkan ketika panggilan balik dipanggil di IRQL = PASSIVE_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Windows
Header	wsk.h (termasuk Wsk.h)
IRQL	<= DISPATCH_LEVEL