header vmbuskernelmodeclientlibapi.h

Header ini digunakan oleh jaringan. Untuk informasi selengkapnya, lihat:

• Jaringan

vmbuskernelmodeclientlibapi.h berisi antarmuka pemrograman berikut:

Fungsi

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT Fungsi VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT menyimpan fungsi panggilan balik yang akan digunakan untuk perubahan status untuk saluran.

Fungsi panggilan balik

EVT_VMB_CHANNEL_CLOSED Fungsi panggilan balik EvtVmbChannelClosed dipanggil ketika titik akhir klien di komputer virtual tamu menutup saluran dengan menggunakan fungsi VmbChannelDisable, atau titik akhir yang berlawanan membatalkan atau menutup saluran.
EVT_VMB_CHANNEL_OPENED Fungsi panggilan balik EvtVmbChannelOpened dipanggil ketika titik akhir klien di komputer virtual tamu membuka saluran yang telah ditawarkan kepadanya.
EVT_VMB_CHANNEL_PNP_FAILURE Fungsi panggilan balik EvtChannelPnpFailure dipanggil jika titik akhir klien di komputer virtual tamu secara asinkron gagal terhubung meskipun perangkat PnP berada.
EVT_VMB_CHANNEL_POST_STARTED Fungsi panggilan balik EvtVmbChannelPostStarted dipanggil di salah satu titik akhir setelah paket dapat diterima dari titik akhir yang berlawanan.
EVT_VMB_CHANNEL_PROCESS_PACKET Fungsi panggilan balik EvtVmbChannelProcessPacket dipanggil ketika paket tiba di buffer cincin masuk.
EVT_VMB_CHANNEL_PROCESSING_COMPLETE Fungsi panggilan balik EvtVmbChannelProcessingComplete dipanggil ketika sekelompok paket telah dikirimkan oleh fungsi EvtVmbChannelProcessPacket, jika ada jeda sebelum mengirimkan paket berikutnya.
EVT_VMB_CHANNEL_RESTORE_PACKET Fungsi panggilan balik EvtVmbChannelRestorePacket dipanggil ketika titik akhir server penyedia layanan virtualisasi (VSP) harus memulihkan status yang terkait dengan objek paket.
EVT_VMB_CHANNEL_SAVE_PACKET Fungsi panggilan balik EvtVmbChannelSavePacket dipanggil ketika titik akhir penyedia layanan virtualisasi (VSP) harus menyimpan status yang terkait dengan paket.
EVT_VMB_CHANNEL_STARTED 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.
EVT_VMB_CHANNEL_SUSPEND Fungsi panggilan balik EvtVmbChannelSuspend dipanggil di titik akhir server ketika saluran sedang ditutup atau dihapus oleh titik akhir klien, yang memindahkan server ke status Dihentikan.
EVT_VMB_PACKET_COMPLETION_ROUTINE Fungsi panggilan balik EvtVmbPacketCompletionRoutine dipanggil ketika transaksi yang terkait dengan paket terkirim selesai.
FN_VMB_CHANNEL_ALLOCATE Fungsi VmbChannelAllocate mengalokasikan saluran VMBus baru yang memiliki parameter dan panggilan balik default.
FN_VMB_CHANNEL_CLEANUP Fungsi VmbChannelCleanup membuang saluran yang dialokasikan dengan menggunakan fungsi VmbChannelAllocate atau diinisialisasi dengan menggunakan fungsi inisialisasi saluran VMBus.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER Fungsi VmbChannelCreateGpadlFromBuffer membuat Daftar Deskriptor Alamat Fisik Tamu (GPADL) yang menjelaskan buffer sisi klien. GPADL dapat digunakan di server untuk mengakses buffer.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL Fungsi VmbChannelCreateGpadlFromMdl membuat Daftar Deskriptor Alamat Fisik Tamu (GPADL) yang menjelaskan buffer sisi klien. GPADL dapat digunakan di server untuk mengakses buffer.
FN_VMB_CHANNEL_DELETE_GPADL Fungsi VmbChannelDeleteGpadl menghapus Daftar Deskriptor Alamat Fisik Tamu (GPADL) yang dipetakan oleh fungsi VmbChannelCreateGpadlFromMdl atau VmbChannelCreateGpadlFromBuffer.
FN_VMB_CHANNEL_DISABLE Fungsi VmbChannelDisable menonaktifkan saluran, yang menutupnya untuk saluran klien dan mencabut penawaran saluran untuk saluran server. Fungsi ini menunggu sampai saluran benar-benar terkoyak sebelum kembali.
FN_VMB_CHANNEL_ENABLE Fungsi VmbChannelEnable memungkinkan saluran yang dalam keadaan dinonaktifkan dengan menyambungkan ke VMBus dan menawarkan atau membuka saluran, yang sesuai untuk jenis titik akhir.
FN_VMB_CHANNEL_GET_INTERFACE_INSTANCE Fungsi VmbChannelGetInterfaceInstance mendapatkan instans antarmuka aktif, yang merupakan GUID yang secara unik mengidentifikasi saluran.
FN_VMB_CHANNEL_GET_MMIO_SPACE Fungsi VmbChannelGetMmioSpace mengambil alamat virtual kernel ruang MMIO yang dialokasikan untuk saluran.
FN_VMB_CHANNEL_GET_POINTER Fungsi VmbChannelGetPointer memungkinkan driver klien mengambil pointer yang sebelumnya disimpan dengan menggunakan fungsi VmbPacketSetPointer.
FN_VMB_CHANNEL_INIT_SET_CLIENT_CONTEXT_SIZE Fungsi VmbChannelInitSetClientContextSize mengatur ukuran area konteks opsional yang dialokasikan untuk driver klien pada setiap paket masuk.
FN_VMB_CHANNEL_INIT_SET_FLAGS Fungsi VmbChannelInitSetFlags menetapkan bendera yang umum untuk titik akhir saluran server atau klien.
FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME Fungsi VmbChannelInitSetFriendlyName menetapkan nama yang mudah diingat dari saluran Pustaka Klien Mode Kernel (KMCL). Nama yang mudah diingat digunakan untuk penelusuran kesalahan dan penamaan instans penghitung kinerja.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA Fungsi VmbChannelInitSetMaximumExternalData menetapkan ukuran maksimum dan panjang rantai data yang dijelaskan oleh paket, tetapi tidak langsung dikirim dalam paket. Artinya, ukuran maksimum buffer yang dijelaskan oleh ExternalDataMdl.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE Fungsi VmbChannelInitSetMaximumPacketSize menetapkan ukuran paket maksimum yang dapat dikirimkan melalui saluran, yang merupakan ukuran maksimum yang pernah ditentukan oleh fungsi VmbPacketSend.
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS Fungsi VmbChannelInitSetProcessPacketCallbacks mengatur fungsi panggilan balik untuk pemrosesan paket.
FN_VMB_CHANNEL_INIT_SET_STATE_CHANGE_CALLBACKS Fungsi VmbChannelInitSetStateChangeCallbacks mengatur fungsi panggilan balik opsional untuk perubahan status.
FN_VMB_CHANNEL_MAP_GPADL Fungsi VmbChannelMapGpadl memetakan buffer sisi klien ke ruang alamat fisik sisi server dengan menggunakan nomor Daftar Deskriptor Alamat Fisik Tamu (GPADL).
FN_VMB_CHANNEL_PACKET_COMPLETE Fungsi VmbChannelPacketComplete membersihkan pemetaan memori yang luar biasa, merilis buffer apa pun yang digunakan, dan, jika titik akhir yang berlawanan meminta paket penyelesaian, mengirimkan paket penyelesaian.
FN_VMB_CHANNEL_PACKET_DEFER_TO_PASSIVE Fungsi VmbChannelPacketDeferToPassive dipanggil oleh driver klien untuk menunda paket yang diteruskan ke dalamnya oleh fungsi panggilan balik EvtVmbChannelProcessPacket.
FN_VMB_CHANNEL_PACKET_FAIL Fungsi VmbChannelPacketFail gagal dalam paket selama pemrosesan paket karena kesalahan yang tidak dapat dipulihkan. Fungsi ini menghentikan antrean.
FN_VMB_CHANNEL_PACKET_GET_EXTERNAL_DATA Fungsi VmbChannelPacketGetExternalData mendapatkan Daftar Deskriptor Memori (MDL) eksternal yang terkait dengan paket selama pemrosesan paket.
FN_VMB_CHANNEL_PAUSE Fungsi VmbChannelPause memindahkan saluran ke status dijeda, yang mencegah I/O baru.
FN_VMB_CHANNEL_RESTORE_FROM_BUFFER Fungsi VmbChannelRestoreFromBuffer memulihkan status klien dari status yang disimpan sebelumnya. Driver harus memeriksa nilai pengembalian fungsi.
FN_VMB_CHANNEL_SAVE_BEGIN Fungsi VmbChannelSaveBegin menginisialisasi konteks untuk menyimpan status saluran. Driver harus memeriksa nilai pengembalian fungsi.
FN_VMB_CHANNEL_SAVE_CONTINUE Fungsi VmbChannelSaveContinue menyimpan status saluran ke buffer. Jalankan VmbChannelSaveBegin sebelum Anda menjalankan fungsi ini. Driver harus memeriksa nilai pengembalian fungsi.
FN_VMB_CHANNEL_SAVE_END Fungsi VmbChannelSaveEnd membersihkan sumber daya apa pun yang dialokasikan untuk menghemat status saluran.
FN_VMB_CHANNEL_SEND_SYNCHRONOUS_REQUEST Fungsi VmbChannelSendSynchronousRequest mengirimkan paket ke titik akhir yang berlawanan dan menunggu respons.
FN_VMB_CHANNEL_SET_INCOMING_PROCESSING_AT_PASSIVE Fungsi VmbChannelSetIncomingProcessingAtPassive mengatur IRQL yang diperlukan untuk rutinitas penguraian masuk untuk saluran ke PASSIVE_LEVEL.
FN_VMB_CHANNEL_SET_INTERRUPT_LATENCY Komputer virtual tamu memperbarui latensi monitor keluar untuk gangguan MNF.
FN_VMB_CHANNEL_SET_POINTER Fungsi VmbChannelSetPointer menyimpan penunjuk arbitrer dalam konteks saluran.
FN_VMB_CHANNEL_SET_TRANSACTION_QUOTA Fungsi VmbChannelSetTransactionQuota menetapkan kuota paket masuk.
FN_VMB_CHANNEL_SIZEOF_PACKET Fungsi VmbChannelSizeofPacket menghitung ukuran yang diperlukan untuk buffer yang akan digunakan dengan fungsi VmbPacketInitialize.
FN_VMB_CHANNEL_START Fungsi VmbChannelStart memindahkan saluran keluar dari status dijeda.
FN_VMB_CHANNEL_UNMAP_GPADL Fungsi VmbChannelUnmapGpadl membatalkan peta Daftar Deskriptor Alamat Fisik Tamu (GPADL) yang dipetakan menggunakan oleh fungsi VmbChannelMapGpadl. Buffer tidak boleh lagi digunakan oleh server sebelum fungsi ini dipanggil.
FN_VMB_CLIENT_CHANNEL_INIT_SET_RING_BUFFER_PAGE_COUNT Fungsi VmbClientChannelInitSetRingBufferPageCount mengatur jumlah halaman memori yang dialokasikan klien untuk buffer cincin masuk dan keluar.
FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP Fungsi VmbClientChannelInitSetTargetPnp menetapkan target saluran klien berdasarkan jenis antarmuka dan ID instans.
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE Fungsi VmbConvertVmbusHandleToKernelHandle mengonversi handel VMBus mode pengguna ke handel mode kernel.
FN_VMB_PACKET_ALLOCATE Fungsi VmbPacketAllocate mengalokasikan paket dari daftar tampilan saluran.
FN_VMB_PACKET_FREE Fungsi VmbPacketFree merilis paket yang dialokasikan dengan menggunakan fungsi VmbPacketAllocate.
FN_VMB_PACKET_GET_CHANNEL Fungsi VmbPacketGetChannel mengembalikan saluran VMBus tempat paket VMBus dikaitkan.
FN_VMB_PACKET_GET_POINTER Fungsi VmbPacketGetPointer mengambil penunjuk yang sebelumnya disimpan dengan menggunakan fungsi VmbPacketSetPointer.
FN_VMB_PACKET_INITIALIZE Fungsi VmbPacketInitialize menginisialisasi buffer untuk berisi paket VMBus.
FN_VMB_PACKET_RESTORE Fungsi VmbPacketRestore memulihkan paket dari buffer yang berisi konteks paket yang disimpan.
FN_VMB_PACKET_SEND Fungsi VmbPacketSend mengirimkan data dalam buffer paket atau Daftar Deskriptor Memori (MDL) data eksternal. Fungsi ini mengaitkan data tersebut dengan objek paket VMBus, yang mewakili paket sepanjang masa pakai transaksi.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL Fungsi VmbPacketSendWithExternalMdl mengirimkan data dalam buffer paket atau Daftar Deskriptor Memori (MDL) data eksternal.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS Fungsi VmbPacketSendWithExternalPfns mengirimkan data dalam buffer paket atau data eksternal sebagai array Nomor Bingkai Halaman (PFN).
FN_VMB_PACKET_SET_COMPLETION_ROUTINE Fungsi VmbPacketSetCompletionRoutine mengatur rutinitas penyelesaian untuk objek paket.
FN_VMB_PACKET_SET_POINTER Fungsi VmbPacketSetPointer menyimpan penunjuk arbitrer dalam konteks paket.
FN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS Fungsi VmbServerChannelInitSetFlags menetapkan bendera yang unik untuk titik akhir saluran server.
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES Fungsi VmbServerChannelInitSetMmioMegabytes menentukan jumlah, megabyte, ruang I/O yang dipetakan memori tamu (MMIO) untuk dicadangkan untuk perangkat.
FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS Fungsi VmbServerChannelInitSetSaveRestorePacketCallbacks mengatur fungsi simpan dan pulihkan panggilan balik yang dipanggil untuk setiap paket saat driver memanggil fungsi penyimpanan, seperti VmbChannelSaveBegin, VmbChannelSaveContinue, dan VmbChannelSaveEnd, atau fungsi VmbChannelRestoreFromBuffer.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID Fungsi VmbServerChannelInitSetTargetInterfaceId menetapkan jenis antarmuka target GUID dan GUID instans penawaran saluran.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL Fungsi VmbServerChannelInitSetTargetVtl menetapkan target VTL untuk saluran ini. Saluran akan ditawarkan kepada klien yang berjalan di VTL yang ditentukan dan tidak ada yang lain.
FN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE Fungsi VmbServerChannelInitSetVmbusHandle mengaitkan instans VMBus dengan saluran ini.

Struktur

KMCL_SERVER_ONLY_METHODS Struktur KMCL_SERVER_ONLY_METHODS berisi penunjuk fungsi untuk fungsi khusus server untuk antarmuka VMBus Kernel Mode Client Library (KMCL).
KMCL_SERVER_ONLY_METHODS_V5 Struktur KMCL_CLIENT_INTERFACE_V1 berisi penunjuk fungsi untuk fungsi klien untuk antarmuka VMBus Kernel Mode Client Library (KMCL).
VMB_CHANNEL_STATE_CHANGE_CALLBACKS Struktur VMB_CHANNEL_STATE_CHANGE_CALLBACKS berisi fungsi panggilan balik yang terkait dengan perubahan status untuk saluran.