FN_VMB_CHANNEL_MAP_GPADL fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)
[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 |
---|---|
|
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 |