struktur KMCL_SERVER_ONLY_METHODS (vmbuskernelmodeclientlibapi.h)

Artikel
08/08/2023

Struktur KMCL_SERVER_ONLY_METHODS berisi penunjuk fungsi untuk fungsi khusus server untuk antarmuka VMBus Kernel Mode Client Library (KMCL).

Untuk informasi selengkapnya tentang cara mengakses antarmuka KMCL, lihat bagian Keterangan.

Sintaks

typedef struct _KMCL_SERVER_ONLY_METHODS {
  PFN_VMB_CHANNEL_MAP_GPADL                                     VmbChannelMapGpadl;
  PFN_VMB_CHANNEL_RESTORE_FROM_BUFFER                           VmbChannelRestoreFromBuffer;
  PFN_VMB_CHANNEL_SAVE_BEGIN                                    VmbChannelSaveBegin;
  PFN_VMB_CHANNEL_SAVE_CONTINUE                                 VmbChannelSaveContinue;
  PFN_VMB_CHANNEL_SAVE_END                                      VmbChannelSaveEnd;
  PFN_VMB_CHANNEL_UNMAP_GPADL                                   VmbChannelUnmapGpadl;
  PFN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE                 VmbConvertVmbusHandleToKernelHandle;
  PFN_VMB_PACKET_RESTORE                                        VmbPacketRestore;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS                         VmbServerChannelInitSetFlags;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES                VmbServerChannelInitSetMmioMegabytes;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS VmbServerChannelInitSetSaveRestorePacketCallbacks;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID           VmbServerChannelInitSetTargetInterfaceId;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL                    VmbServerChannelInitSetTargetVtl;
  PFN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE                  VmbServerChannelInitSetVmbusHandle;
} KMCL_SERVER_ONLY_METHODS;

Anggota

VmbChannelMapGpadl

Penunjuk ke fungsi VmbChannelMapGpadl .

VmbChannelRestoreFromBuffer

Penunjuk ke fungsi VmbChannelRestoreFromBuffer .

VmbChannelSaveBegin

Penunjuk ke fungsi VmbChannelSaveBegin .

VmbChannelSaveContinue

Penunjuk ke fungsi VmbChannelSaveContinue .

VmbChannelSaveEnd

Penunjuk ke fungsi VmbChannelSaveEnd .

VmbChannelUnmapGpadl

Penunjuk ke fungsi VmbChannelUnmapGpadl .

VmbConvertVmbusHandleToKernelHandle

Penunjuk ke fungsi VmbConvertVmbusHandleToKernelHandle .

VmbPacketRestore

Penunjuk ke fungsi VmbPacketRestore .

VmbServerChannelInitSetFlags

Penunjuk ke fungsi VmbServerChannelInitSetFlags .

VmbServerChannelInitSetMmioMegabytes

Penunjuk ke fungsi VmbServerChannelInitSetMmioMegabytes .

VmbServerChannelInitSetSaveRestorePacketCallbacks

Penunjuk ke fungsi VmbServerChannelInitSetSaveRestorePacketCallbacks .

VmbServerChannelInitSetTargetInterfaceId

Penunjuk ke fungsi VmbServerChannelInitSetTargetInterfaceId .

VmbServerChannelInitSetTargetVtl

Penunjuk ke fungsi VmbServerChannelInitSetTargetVtl .

VmbServerChannelInitSetVmbusHandle

Penunjuk ke fungsi VmbServerChannelInitSetVmbusHandle .

Keterangan

Penunjuk fungsi di KMCL_SERVER_ONLY_METHODS dipanggil melalui antarmuka VMBus Kernel Mode Client Library (KMCL), yang disediakan oleh driver bus Vmbkmcl.sys. Struktur ini berisi penunjuk fungsi untuk fungsi khusus server.

Untuk mengakses fungsi klien dan server saja dari antarmuka KMCL, alokasikan struktur KMCL_SERVER_INTERFACE_V1 untuk menerima antarmuka, lalu panggil WdfFdoQueryForInterface atau WdfIoTargetQueryForInterface dengan parameter ini:

Parameter InterfaceType : KMCL_SERVER_INTERFACE_TYPE
Parameter ukuran : sizeof(KMCL_SERVER_INTERFACE_V1)
Parameter versi : KMCL_SERVER_INTERFACE_VERSION_V1

Struktur KMCL_SERVER_INTERFACE_V1 didefinisikan sebagai berikut untuk kode bahasa C:

typedef struct _KMCL_SERVER_INTERFACE_V1 {
    KMCL_CLIENT_INTERFACE_V1;
    KMCL_SERVER_ONLY_METHODS;
} KMCL_SERVER_INTERFACE_V1, *PKMCL_SERVER_INTERFACE_V1;

Jika fungsi kueri antarmuka berhasil, struktur KMCL_SERVER_INTERFACE_V1 berisi struktur KMCL_CLIENT_INTERFACE_V1 dan struktur KMCL_SERVER_ONLY_METHODS . Struktur KMCL_SERVER_ONLY_METHODS berisi penunjuk fungsi yang dapat Anda gunakan untuk memanggil fungsi khusus server VMBus KMCL.

Untuk metode klien KMCL, lihat struktur KMCL_CLIENT_INTERFACE_V1 .

Untuk informasi selengkapnya tentang antarmuka yang ditentukan driver, lihat Menggunakan Antarmuka Driver-Defined.