Share via

FN_VMB_CHANNEL_SAVE_CONTINUE 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 VmbChannelSaveContinue menyimpan status saluran ke buffer. Jalankan VmbChannelSaveBegin sebelum Anda menjalankan fungsi ini. Driver harus memeriksa nilai pengembalian fungsi.

Sintaks

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Parameter

Channel

Handel untuk saluran yang akan disimpan.

SaveBuffer

Penunjuk ke buffer tempat menyimpan informasi status.

SaveBufferSize

Ukuran, dalam byte, dari buffer penyimpanan.

BytesFilled

Penunjuk ke variabel yang menerima jumlah byte yang disalin ke buffer penyimpanan.

BytesRequired

Penunjuk ke variabel yang menerima jumlah byte yang diperlukan agar fungsi ini membuat kemajuan pada panggilan berikutnya.

Nilai kembali

VmbChannelSaveContinue mengembalikan nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Status telah disimpan.
STATUS_BUFFER_TOO_SMALL
Buffer penyimpanan terlalu kecil. Parameter BytesNeeded berisi jumlah byte yang diperlukan untuk membuat kemajuan apa pun.
STATUS_STATUS_BUFFER_OVERFLOW
 Beberapa data ditulis ke buffer penyimpanan, tetapi ada lebih banyak data yang akan disimpan.

Keterangan

Proses penyimpanan menyimpan data dalam "potongan" dan dapat berlanjut dari titik dihentikan.

Jika penelepon tidak mengalokasikan cukup ruang terlebih dahulu, beberapa panggilan mungkin diperlukan.

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

VmbChannelSaveBegin