FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL 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 VmbChannelCreateGpadlFromMdl membuat Daftar Deskriptor Alamat Fisik Tamu (GPADL) yang menjelaskan buffer sisi klien. GPADL dapat digunakan di server untuk mengakses buffer.

Sintaks

FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL FnVmbChannelCreateGpadlFromMdl;

NTSTATUS FnVmbChannelCreateGpadlFromMdl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PMDL Mdl,
  UINT32 StartOffsetWithinMdl,
  UINT32 DataLengthWithinMdl,
  PUINT32 GpadlHandle
)
{...}

Parameter

Channel

Handel untuk saluran.

Flags

Bendera. Nilai yang mungkin adalah sebagai berikut:

Nilai Makna
VMBUS_CHANNEL_GPADL_READ_ONLY
 Jika Anda menentukan nilai ini, buffer bersifat baca-saja. Jika tidak, server dapat menulis ke buffer. Ini bukan ukuran keamanan, tetapi dapat meningkatkan rekam jepret dan performa migrasi langsung.

Mdl

Penunjuk ke rantai Daftar Deskriptor Memori (MDL) yang menjelaskan buffer. Buffer mungkin memiliki beberapa bagian, yang dirangkai dengan menggunakan penunjuk berikutnya MDL.

StartOffsetWithinMdl

Offset, dalam byte, di MDL tempat memulai pemetaan.

DataLengthWithinMdl

Panjangnya, dalam byte, dari rantai buffer. Jika nilai ini nol (0), gunakan hingga akhir MDL.

GpadlHandle

Handel GPADL dari MDL yang dibuat. Kirim ini ke server untuk digunakan dengan fungsi VmbChannelMapGpadl .

Mengembalikan nilai

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

Keterangan

Ketika fungsi ini kembali, titik akhir server dapat memanggil VmbChannelMapGpadl, karena VMBus sudah akan mengirim deskripsi GPADL ke titik akhir yang berlawanan dan menerima konfirmasi.

GPADL harus dihapus dengan menggunakan fungsi VmbChannelDeleteGpadl .

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

VmbChannelDeleteGpadl

VmbChannelMapGpadl