EVT_VMB_CHANNEL_STARTED fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)

Artikel
02/29/2024

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat atau tersirat, sehubungan dengan informasi yang diberikan di sini.]

Fungsi panggilan balik EvtVmbChannelStarted dipanggil di salah satu titik akhir ketika saluran dikonfigurasi sepenuhnya tetapi sebelum paket apa pun dikirimkan. Ini terjadi ketika titik akhir yang berlawanan membuka saluran atau membukanya kembali setelah menutupnya.

Sintaks

EVT_VMB_CHANNEL_STARTED EvtVmbChannelStarted;

void EvtVmbChannelStarted(
  [in] VMBCHANNEL Channel
)
{...}

Parameter

[in] Channel

Saluran yang dimulai.

Mengembalikan nilai

Tidak ada

Keterangan

Setelah saluran dibuat, driver klien dapat menentukan fungsi panggilan balik untuk perubahan status, termasuk EvtVmbChannelStarted, dengan menggunakan fungsi VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT .

Jika saluran yang dijeda dibuka atau saluran yang dibuka dimulai, Pustaka Klien Mode Kernel (KMCL) memanggil EvtVmbChannelStarted setelah memanggil panggilan balik EvtVmbChannelOpened . EvtVmbChannelStarted dapat memanggil fungsi VmbPacketSend, VmbPacketSendWithExternalMdl, dan VmbPacketSendWithExternalPfns untuk mengantre paket keluar. Karena antrean masuk tidak berjalan pada saat ini, panggilan balik ini tidak boleh memblokir paket atau penyelesaian yang masuk.

Sebagian besar driver yang menggunakan KMCL tidak menerapkan panggilan balik ini. Alternatifnya adalah fungsi panggilan balik EvtVmbChannelPostStarted .

Menunggu paket terkirim selesai, seperti oleh fungsi VmbChannelSendSynchronousRequest , tidak pernah kembali karena paket tidak mengalir ketika panggilan balik ini dipanggil.