FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP 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 VmbClientChannelInitSetTargetPnp menetapkan target saluran klien berdasarkan jenis antarmuka dan ID instans. Jika fungsi ini dipanggil, Pustaka Klien Mode Kernel (KMCL) menggunakan PnP untuk menemukan Objek Perangkat Fisik (PDO) VMBus yang sesuai dengan antarmuka yang disediakan.

Sintaks

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

Parameter

Channel

Pointer ke saluran.

InterfaceType

Pointer ke jenis antarmuka GUID. GUID ini mengidentifikasi jenis saluran dan protokol yang digunakan dengan saluran.

InterfaceInstance

Penunjuk ke JENIS instans GUID. Ini adalah instans layanan tertentu. Jika tidak disediakan, instans apa pun dengan jenis yang disediakan diterima.

PnpFailureCallback

Penunjuk ke panggilan balik peristiwa untuk memanggil jika perangkat gagal tersambung secara asinkron meskipun perangkat PnP berada.

Nilai kembali

VmbClientChannelInitSetTargetPnp mengembalikan nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER_1
 Nilai Saluran tidak valid atau dalam status tidak valid, seperti Dinonaktifkan.

Keterangan

Jika Anda memiliki dua antarmuka jaringan paravirtual, antarmuka tersebut akan memiliki InterfaceType yang sama tetapi nilai InterfaceInstance yang berbeda.

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