FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)

  • Artikel

[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 VmbPacketSendWithExternalPfns mengirimkan data dalam buffer paket atau data eksternal sebagai array Nomor Bingkai Halaman (PFN). Fungsi ini mengaitkan data tersebut dengan objek paket VMBus, yang mewakili paket sepanjang masa pakai transaksi.

Sintaks

FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS FnVmbPacketSendWithExternalPfns;

NTSTATUS FnVmbPacketSendWithExternalPfns(
  __drv_aliasesMem VMBPACKET PacketObject,
  PVOID Buffer,
  UINT32 BufferLength,
  PPFN_NUMBER ExternalDataPfns,
  UINT32 PfnLength,
  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 .

ExternalDataPfns

Array Nomor Bingkai Halaman yang menjelaskan buffer data yang terkait dengan paket.

PfnLength

Jumlah PFN yang akan dikirim dari ExternalDataPfns. Indeks array yang dirujuk akhir bersifat ExternalDataPfns[PfnOffset+PfnLength-1] inklusif.

Flags

Bendera. Berikut ini adalah bendera yang berkaitan:

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. Bendera ini harus diatur.
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.

Nilai kembali

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

Keterangan

Fungsi ini berbeda dari fungsi VmbPacketSend karena memungkinkan melewati array PFN, secara efektif alamat fisik.

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

VmbPacketSend