FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)

Artikel
02/29/2024

[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 VmbChannelCreateGpadlFromBuffer 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_BUFFER FnVmbChannelCreateGpadlFromBuffer;

NTSTATUS FnVmbChannelCreateGpadlFromBuffer(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PVOID Buffer,
  UINT32 ByteCount,
  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.

Buffer

Buffer, yang diselimuti dan dikunci sampai GPADL dirobohkan.

ByteCount

Panjang buffer, dalam byte.

GpadlHandle

Handel GPADL dari Daftar Deskriptor Memori (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

Bagikan melalui