Share via

FN_VMB_CHANNEL_MAP_GPADL 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 VmbChannelMapGpadl memetakan buffer sisi klien ke ruang alamat fisik sisi server dengan menggunakan nomor Daftar Deskriptor Alamat Fisik Tamu (GPADL).

Sintaks

FN_VMB_CHANNEL_MAP_GPADL FnVmbChannelMapGpadl;

NTSTATUS FnVmbChannelMapGpadl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  UINT32 GpadlHandle,
  PMDL *Mdl
)
{...}

Parameter

Channel

Handel untuk saluran.

Flags

Bendera. Nilai bendera yang mungkin adalah:

Nilai Makna
VMBUS_CHANNEL_GPADL_FLAG_READ_ONLY
 Petakan dengan akses baca-saja.
 

Jika nilai bendera ini tidak diatur, fungsi mencoba memetakan GPADL untuk akses tulis. Jika GPADL tidak dibuat dengan akses tulis, upaya pemetaan ini gagal. Pemanggil tidak dicegah menulis ke buffer jika bendera ini diatur. Skema ini digunakan untuk meningkatkan performa migrasi langsung dan rekam jepret.

GpadlHandle

Handel GPADL GPADL untuk dipetakan.

Mdl

Pointer ke MDL yang menjelaskan buffer klien. Buffer ini hanya dipetakan ke ruang alamat fisik. Pemanggil harus mengambil langkah tambahan untuk memetakannya ke ruang alamat virtual.

Mengembalikan nilai

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

Keterangan

GPADL harus telah dibuat sebelumnya oleh klien, misalnya, dengan menggunakan fungsi VmbChannelCreateGpadlFromBuffer .

Hanya satu pemetaan yang mungkin ada untuk GPADL tertentu pada satu waktu.

Anda harus memasangkan panggilan ke fungsi ini dengan panggilan ke fungsi VmbChannelUnmapGpadl .

Penting

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

Untuk informasi selengkapnya, lihat bagian Keterangan di KMCL_SERVER_ONLY_METHODS.

Persyaratan

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

Lihat juga

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl