FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA 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 maupun tersirat, sehubungan dengan informasi yang diberikan di sini.]

Fungsi VmbChannelInitSetMaximumExternalData menetapkan ukuran maksimum dan panjang rantai data yang dijelaskan oleh paket, tetapi tidak langsung dikirim dalam paket. Artinya, ukuran maksimum buffer yang dijelaskan oleh ExternalDataMdl.

Sintaks

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Parameter

Channel

Penunjuk ke saluran Pustaka Klien Mode Kernel (KMCL).

DataSize

Ukuran maksimum data eksternal.

ChainLength

Jumlah maksimum Lists Deskriptor Memori (MDL) dalam rantai MDL masuk.

Nilai kembali

VmbChannelInitSetMaximumExternalData dapat mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Fungsi berhasil diselesaikan.
STATUS_INVALID_PARAMETER_1
 Nilai Saluran tidak valid atau dalam status tidak valid, seperti Dinonaktifkan.
STATUS_INVALID_PARAMETER_2
 Nilai DataSize tidak valid. Nol (0) tidak valid.
STATUS_INVALID_PARAMETER_3
 Nilai ChainLength tidak valid. Nol (0) tidak valid.

Keterangan

KMCL memastikan bahwa buffer cincin Anda cukup besar untuk mengirim paket yang berisi buffer dalam batas yang ditentukan.

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