FN_VMB_PACKET_SEND fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)

Artikel
03/01/2024

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

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.

Sintaks

FN_VMB_PACKET_SEND FnVmbPacketSend;

NTSTATUS FnVmbPacketSend(
  __drv_aliasesMem VMBPACKET PacketObject,
  PVOID Buffer,
  UINT32 BufferLength,
  PMDL ExternalDataMdl,
  UINT32 Flags
)
{...}

Parameter

PacketObject

Handel ke objek paket VMBus.

Buffer

Buffer yang berisi paket perintah yang dikirim melalui buffer cincin VMBus.

BufferLength

Panjangnya, dalam byte, dari buffer dalam parameter Buffer .

ExternalDataMdl

MDL yang menjelaskan buffer data yang terkait dengan paket.

Flags

Bendera. Berikut ini adalah bendera terkait:

Nilai	Makna
VMBUS_CHANNEL_FORMAT_FLAG_WAIT_FOR_COMPLETION	Paket ini tidak dapat dianggap lengkap dan sumber dayanya tidak dapat dirilis sampai paket penyelesaian kembali dari titik akhir yang berlawanan.
VMBUS_CHANNEL_FORMAT_FLAG_PAGED_BUFFER	Buffer sebaris di-paged dan harus diperlakukan sesuai, yang berarti harus disalin sebelum memasuki tingkat DPC. Memeriksa buffer mode pengguna atau menangani pelanggaran akses adalah tanggung jawab pemanggil.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil, atau kode kesalahan NTSTATUS yang sesuai sebaliknya.

Keterangan

Untuk informasi tentang cara lain untuk mengirim paket, lihat fungsi VmbPacketSendWithExternalMdl, VmbChannelSendSynchronousRequest, dan VmbPacketSendWithExternalPfns .

Penting

Fungsi ini dipanggil melalui antarmuka VMBus Kernel Mode Client Library (KMCL), yang disediakan oleh driver bus Vmbkmcl.sys. Ini adalah fungsi klien yang diakses dari struktur KMCL_CLIENT_INTERFACE_V1 .

Untuk informasi selengkapnya, lihat bagian Keterangan dari KMCL_CLIENT_INTERFACE_V1.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 versi 1803
Header	vmbuskernelmodeclientlibapi.h

Lihat juga

VmbChannelSendSynchronousRequest

VmbPacketSendWithExternalMdl

VmbPacketSendWithExternalPfns

Share via