структура KMCL_SERVER_ONLY_METHODS (vmbuskernelmodeclientlibapi.h)

Статья
08/08/2023

Структура KMCL_SERVER_ONLY_METHODS содержит указатели функций только для серверных функций для интерфейса клиентской библиотеки (KMCL) режима ядра виртуальной машины.

Дополнительные сведения о доступе к интерфейсу KMCL см. в разделе Примечания.

Синтаксис

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;

Члены

VmbChannelMapGpadl

Указатель на функцию VmbChannelMapGpadl .

VmbChannelRestoreFromBuffer

Указатель на функцию VmbChannelRestoreFromBuffer .

VmbChannelSaveBegin

Указатель на функцию VmbChannelSaveBegin .

VmbChannelSaveContinue

Указатель на функцию VmbChannelSaveContinue .

VmbChannelSaveEnd

Указатель на функцию VmbChannelSaveEnd .

VmbChannelUnmapGpadl

Указатель на функцию VmbChannelUnmapGpadl .

VmbConvertVmbusHandleToKernelHandle

Указатель на функцию VmbConvertVmbusHandleToKernelHandle .

VmbPacketRestore

Указатель на функцию VmbPacketRestore .

VmbServerChannelInitSetFlags

Указатель на функцию VmbServerChannelInitSetFlags .

VmbServerChannelInitSetMmioMegabytes

Указатель на функцию VmbServerChannelInitSetMmioMegabytes .

VmbServerChannelInitSetSaveRestorePacketCallbacks

Указатель на функцию VmbServerChannelInitSetSaveRestorePacketCallbacks .

VmbServerChannelInitSetTargetInterfaceId

Указатель на функцию VmbServerChannelInitSetTargetInterfaceId .

VmbServerChannelInitSetTargetVtl

Указатель на функцию VmbServerChannelInitSetTargetVtl .

VmbServerChannelInitSetVmbusHandle

Указатель на функцию VmbServerChannelInitSetVmbusHandle .

Указатели функций в KMCL_SERVER_ONLY_METHODS вызываются через интерфейс клиентской библиотеки режима ядра vmbus (KMCL), предоставляемый драйвером Vmbkmcl.sys шины. Эта структура содержит указатели функций только для серверных функций.

Чтобы получить доступ к клиентским и серверным функциям интерфейса KMCL, выделите структуру KMCL_SERVER_INTERFACE_V1 для получения интерфейса, а затем вызовите WdfFdoQueryForInterface или WdfIoTargetQueryForInterface с помощью следующих параметров:

Параметр InterfaceType : KMCL_SERVER_INTERFACE_TYPE
Параметр Size : sizeof(KMCL_SERVER_INTERFACE_V1)
Параметр версии : KMCL_SERVER_INTERFACE_VERSION_V1

Структура KMCL_SERVER_INTERFACE_V1 определяется следующим образом для кода языка C:

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

Если функция запроса интерфейса завершается успешно, структура KMCL_SERVER_INTERFACE_V1 содержит как KMCL_CLIENT_INTERFACE_V1 структуру, так и структуру KMCL_SERVER_ONLY_METHODS . Структура KMCL_SERVER_ONLY_METHODS содержит указатели функций, которые можно использовать для вызова функций KMCL vmBus только для сервера.

Сведения о методах клиента KMCL см. в разделе структура KMCL_CLIENT_INTERFACE_V1 .

Дополнительные сведения об интерфейсах, определяемых драйвером, см. в разделе Использование интерфейсов Driver-Defined.