PFN_WSK_CLIENT_EVENT fungsi panggilan balik (wsk.h)

Fungsi panggilan balik peristiwa WskClientEvent memberi tahu aplikasi WSK tentang peristiwa yang tidak spesifik untuk soket tertentu.

Sintaks

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

NTSTATUS PfnWskClientEvent(
  [in, optional] PVOID ClientContext,
  [in]           ULONG EventType,
  [in, optional] PVOID Information,
  [in]           SIZE_T InformationLength
)
{...}

Parameter

[in, optional] ClientContext

Penunjuk ke nilai konteks yang ditentukan oleh parameter WskClientNpi yang diteruskan ke fungsi WskRegister .

[in] EventType

Peristiwa spesifik tentang aplikasi WSK yang sedang diberi tahu. Saat ini tidak ada peristiwa yang ditentukan.

[in, optional] Information

Penunjuk ke buffer yang berisi informasi tambahan yang terkait dengan peristiwa. Jika tidak ada informasi tambahan yang terkait dengan peristiwa, pointer ini akan menjadi NULL.

[in] InformationLength

Panjang informasi tambahan yang terkandung dalam buffer yang diacu oleh
Parameter informasi . Jika tidak ada informasi tambahan yang terkait dengan peristiwa, nilai ini akan menjadi nol.

Nilai kembali

Fungsi panggilan balik peristiwa WskClientEvent aplikasi WSK dapat mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Pemberitahuan kejadian berhasil diproses.
STATUS_NOT_IMPLEMENTED	Dukungan untuk peristiwa yang diteruskan dalam parameter Peristiwa tidak diimplementasikan.

Keterangan

Saat ini, tidak ada peristiwa yang didefinisikan untuk fungsi panggilan balik peristiwa WskClientEvent . Oleh karena itu, jika aplikasi WSK menerapkan fungsi panggilan balik peristiwa WskClientEvent , aplikasi tersebut harus selalu mengembalikan STATUS_NOT_IMPLEMENTED.

Informasi tambahan yang terkandung dalam buffer yang ditunjukkan oleh parameter Informasi bersifat baca-saja dan hanya berlaku selama durasi panggilan ke fungsi panggilan balik peristiwa WskClientEvent .

Jika aplikasi WSK tidak menerapkan fungsi panggilan balik peristiwa WskClientEvent , aplikasi tersebut harus mengatur anggota WskClientEvent dari struktur WSK_CLIENT_DISPATCH ke NULL sebelum memanggil WskRegister.

Subsistem WSK memanggil fungsi panggilan balik peristiwa WskClientEvent aplikasi WSK di IRQL <= DISPATCH_LEVEL.

Fungsi panggilan balik peristiwa WskClientEvent 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 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

Lihat juga

WSK_CLIENT_DISPATCH

WskRegister