Заголовок vmbuskernelmodeclientlibapi.h

Этот заголовок используется сетью. Дополнительные сведения см. в разделе:

• Network

vmbuskernelmodeclientlibapi.h содержит следующие программные интерфейсы:

Функции

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT Функция VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT сохраняет функции обратного вызова, которые будут использоваться для изменения состояния канала.

Функции обратного вызова

EVT_VMB_CHANNEL_CLOSED Функция обратного вызова EvtVmbChannelClosed вызывается, когда клиентская конечная точка на гостевой виртуальной машине закрывает канал с помощью функции VmbChannelDisable или обратная конечная точка отменяет или закрывает канал.
EVT_VMB_CHANNEL_OPENED Функция обратного вызова EvtVmbChannelOpened вызывается, когда конечная точка клиента на гостевой виртуальной машине открывает канал, который был ей предложен.
EVT_VMB_CHANNEL_PNP_FAILURE Функция обратного вызова EvtChannelPnpFailure вызывается, если конечная точка клиента на гостевой виртуальной машине асинхронно не подключается, даже если было расположено устройство PnP.
EVT_VMB_CHANNEL_POST_STARTED Функция обратного вызова EvtVmbChannelPostStarted вызывается в любой из конечных точек после получения пакетов из противоположной конечной точки.
EVT_VMB_CHANNEL_PROCESS_PACKET Функция обратного вызова EvtVmbChannelProcessPacket вызывается при поступлении пакета во входящий кольцевой буфер.
EVT_VMB_CHANNEL_PROCESSING_COMPLETE Функция обратного вызова EvtVmbChannelProcessingComplete вызывается при доставке группы пакетов функцией EvtVmbChannelProcessPacket, если существует пауза перед доставкой последующих пакетов.
EVT_VMB_CHANNEL_RESTORE_PACKET Функция обратного вызова EvtVmbChannelRestorePacket вызывается, когда конечная точка сервера поставщика услуг виртуализации (VSP) должна восстановить состояние, связанное с объектом пакета.
EVT_VMB_CHANNEL_SAVE_PACKET Функция обратного вызова EvtVmbChannelSavePacket вызывается, когда конечная точка поставщика службы виртуализации (VSP) должна сохранить состояние, связанное с пакетом.
EVT_VMB_CHANNEL_STARTED Функция обратного вызова EvtVmbChannelStarted вызывается в любой конечной точке, когда канал полностью настроен, но до доставки пакетов. Это происходит, когда противоположная конечная точка открыла канал или снова открыла его после закрытия.
EVT_VMB_CHANNEL_SUSPEND Функция обратного вызова EvtVmbChannelSuspend вызывается в конечной точке сервера при закрытии или удалении канала конечной точкой клиента, которая перемещает сервер в состояние Остановлено.
EVT_VMB_PACKET_COMPLETION_ROUTINE Функция обратного вызова EvtVmbPacketCompletionRoutine вызывается после завершения транзакции, связанной с отправленным пакетом.
FN_VMB_CHANNEL_ALLOCATE Функция VmbChannelAllocate выделяет новый канал VMBus с параметрами по умолчанию и обратными вызовами.
FN_VMB_CHANNEL_CLEANUP Функция VmbChannelCleanup удаляет канал, который был выделен с помощью функции VmbChannelAllocate или инициализирован с помощью функции инициализации канала VMBus.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER Функция VmbChannelCreateGpadlFromBuffer создает список дескрипторов гостевых физических адресов (GPADL), описывающий буфер на стороне клиента. GPADL можно использовать на сервере для доступа к буферу.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL Функция VmbChannelCreateGpadlFromMdl создает список дескрипторов гостевых физических адресов (GPADL), описывающий буфер на стороне клиента. GPADL можно использовать на сервере для доступа к буферу.
FN_VMB_CHANNEL_DELETE_GPADL Функция VmbChannelDeleteGpadl удаляет список дескрипторов гостевых физических адресов (GPADL), сопоставленный функциями VmbChannelCreateGpadlFromMdl или VmbChannelCreateGpadlFromBuffer.
FN_VMB_CHANNEL_DISABLE Функция VmbChannelDisable отключает канал, который закрывает его для клиентских каналов и отменяет предложение канала для каналов сервера. Эта функция ожидает, пока канал не будет полностью снесен, прежде чем он вернется.
FN_VMB_CHANNEL_ENABLE Функция VmbChannelEnable включает канал, который находится в отключенном состоянии, подключаясь к VMBus и предлагая или открыв канал в соответствии с типом конечной точки.
FN_VMB_CHANNEL_GET_INTERFACE_INSTANCE Функция VmbChannelGetInterfaceInstance получает активный экземпляр интерфейса, который является ИДЕНТИФИКАТОРом GUID, уникальным образом идентифицирующий канал.
FN_VMB_CHANNEL_GET_MMIO_SPACE Функция VmbChannelGetMmioSpace извлекает виртуальный адрес ядра пространства MMIO, выделенного каналу.
FN_VMB_CHANNEL_GET_POINTER Функция VmbChannelGetPointer позволяет драйверу клиента получить указатель, ранее сохраненный с помощью функции VmbPacketSetPointer.
FN_VMB_CHANNEL_INIT_SET_CLIENT_CONTEXT_SIZE Функция VmbChannelInitSetClientContextSize задает размер необязательной области контекста, выделенной для драйвера клиента для каждого входящего пакета.
FN_VMB_CHANNEL_INIT_SET_FLAGS Функция VmbChannelInitSetFlags задает флаги, общие для конечных точек канала сервера или клиента.
FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME Функция VmbChannelInitSetFriendlyName задает понятное имя канала клиентской библиотеки режима ядра (KMCL). Понятное имя используется для отладки и именования экземпляров счетчика производительности.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA Функция VmbChannelInitSetMaximumExternalData задает максимальный размер и длину цепочки данных, которые описываются пакетом, но не отправляются непосредственно в пакете. То есть максимальный размер буфера, описанный в ExternalDataMdl.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE Функция VmbChannelInitSetMaximumPacketSize задает максимальный размер пакета, который может быть доставлен через канал. Это максимальный размер, который когда-либо будет указан функцией VmbPacketSend.
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS Функция VmbChannelInitSetProcessPacketCallbacks задает функции обратного вызова для обработки пакетов.
FN_VMB_CHANNEL_INIT_SET_STATE_CHANGE_CALLBACKS Функция VmbChannelInitSetStateChangeCallbacks задает необязательные функции обратного вызова для изменения состояния.
FN_VMB_CHANNEL_MAP_GPADL Функция VmbChannelMapGpadl сопоставляет буфер на стороне клиента с физическим адресным пространством на стороне сервера с помощью номера списка дескрипторов гостевых физических адресов (GPADL).
FN_VMB_CHANNEL_PACKET_COMPLETE Функция VmbChannelPacketComplete очищает все оставшиеся сопоставления памяти, освобождает все используемые буферы и, если в противоположной конечной точке запрошен пакет завершения, отправляет пакет завершения.
FN_VMB_CHANNEL_PACKET_DEFER_TO_PASSIVE Функция VmbChannelPacketDeferToPassive вызывается драйвером клиента для отсрочки пакета, переданного ему функцией обратного вызова EvtVmbChannelProcessPacket.
FN_VMB_CHANNEL_PACKET_FAIL Функция VmbChannelPacketFail завершает работу пакета во время обработки пакетов из-за неустранимой ошибки. Эта функция останавливает очередь.
FN_VMB_CHANNEL_PACKET_GET_EXTERNAL_DATA Функция VmbChannelPacketGetExternalData получает все внешние списки дескрипторов памяти (MDL), связанные с пакетом во время обработки пакета.
FN_VMB_CHANNEL_PAUSE Функция VmbChannelPause перемещает канал в приостановленное состояние, что предотвращает новые операции ввода-вывода.
FN_VMB_CHANNEL_RESTORE_FROM_BUFFER Функция VmbChannelRestoreFromBuffer восстанавливает состояние клиента из ранее сохраненного состояния. Драйвер должен проверка возвращаемое значение функции.
FN_VMB_CHANNEL_SAVE_BEGIN Функция VmbChannelSaveBegin инициализирует контекст для сохранения состояния канала. Драйвер должен проверка возвращаемое значение функции.
FN_VMB_CHANNEL_SAVE_CONTINUE Функция VmbChannelSaveContinue сохраняет состояние канала в буфере. Запустите VmbChannelSaveBegin перед запуском этой функции. Драйвер должен проверка возвращаемое значение функции.
FN_VMB_CHANNEL_SAVE_END Функция VmbChannelSaveEnd очищает все ресурсы, выделенные для сохранения состояния канала.
FN_VMB_CHANNEL_SEND_SYNCHRONOUS_REQUEST Функция VmbChannelSendSynchronousRequest отправляет пакет в противоположную конечную точку и ожидает ответа.
FN_VMB_CHANNEL_SET_INCOMING_PROCESSING_AT_PASSIVE Функция VmbChannelSetIncomingProcessingAtPassive задает необходимый irQL для входящих процедур синтаксического анализа канала, чтобы PASSIVE_LEVEL.
FN_VMB_CHANNEL_SET_INTERRUPT_LATENCY Гостевая виртуальная машина обновляет задержку исходящего монитора для прерываний MNF.
FN_VMB_CHANNEL_SET_POINTER Функция VmbChannelSetPointer сохраняет произвольный указатель в контексте канала.
FN_VMB_CHANNEL_SET_TRANSACTION_QUOTA Функция VmbChannelSetTransactionQuota задает квоту входящих пакетов.
FN_VMB_CHANNEL_SIZEOF_PACKET Функция VmbChannelSizeofPacket вычисляет необходимый размер буферов для использования с функцией VmbPacketInitialize.
FN_VMB_CHANNEL_START Функция VmbChannelStart перемещает канал из приостановленного состояния.
FN_VMB_CHANNEL_UNMAP_GPADL Функция VmbChannelUnmapGpadl отменяет сопоставление списка дескрипторов гостевых физических адресов (GPADL), сопоставленного с помощью функции VmbChannelMapGpadl. Буфер больше не должен использоваться сервером перед вызовом этой функции.
FN_VMB_CLIENT_CHANNEL_INIT_SET_RING_BUFFER_PAGE_COUNT Функция VmbClientChannelInitSetRingBufferPageCount задает количество страниц памяти, выделяемой клиентом для входящих и исходящих кольцевых буферов.
FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP Функция VmbClientChannelInitSetTargetPnp задает целевой канал клиента по типу интерфейса и идентификаторам экземпляров.
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE Функция VmbConvertVmbusHandleToKernelHandle преобразует дескриптор VMBus пользовательского режима в дескриптор режима ядра.
FN_VMB_PACKET_ALLOCATE Функция VmbPacketAllocate выделяет пакет из списка lookaside канала.
FN_VMB_PACKET_FREE Функция VmbPacketFree освобождает пакет, выделенный с помощью функции VmbPacketAllocate.
FN_VMB_PACKET_GET_CHANNEL Функция VmbPacketGetChannel возвращает канал VMBus, с которым связан пакет VMBus.
FN_VMB_PACKET_GET_POINTER Функция VmbPacketGetPointer извлекает указатель, ранее сохраненный с помощью функции VmbPacketSetPointer.
FN_VMB_PACKET_INITIALIZE Функция VmbPacketInitialize инициализирует буфер, содержащий пакет VMBus.
FN_VMB_PACKET_RESTORE Функция VmbPacketRestore восстанавливает пакет из буфера, содержащего сохраненный контекст пакета.
FN_VMB_PACKET_SEND Функция VmbPacketSend отправляет данные в буфер пакетов или список внешних дескрипторов памяти (MDL). Функция связывает эти данные с объектом пакета VMBus, который представляет пакет на протяжении всего времени существования транзакции.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL Функция VmbPacketSendWithExternalMdl отправляет данные в буфер пакетов или внешний список дескрипторов памяти (MDL).
FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS Функция VmbPacketSendWithExternalPfns отправляет данные в буфер пакетов или внешние данные в виде массива номеров кадров страниц (PFN).
FN_VMB_PACKET_SET_COMPLETION_ROUTINE Функция VmbPacketSetCompletionRoutine задает подпрограмму завершения для объекта пакета.
FN_VMB_PACKET_SET_POINTER Функция VmbPacketSetPointer сохраняет произвольный указатель в контексте пакета.
FN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS Функция VmbServerChannelInitSetFlags устанавливает флаги, уникальные для конечных точек канала сервера.
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES Функция VmbServerChannelInitSetMmioMegabytes указывает объем пространства ввода-вывода, сопоставленного с гостевой памятью (MMIO), в мегабайтах, который необходимо зарезервировать для устройства.
FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS Функция VmbServerChannelInitSetSaveRestorePacketCallbacks задает функции обратного вызова сохранения и восстановления, которые вызываются для каждого пакета, когда драйвер вызывает функцию сохранения, например VmbChannelSaveBegin, VmbChannelSaveContinue и VmbChannelSaveEnd или функцию VmbChannelRestoreFromBuffer.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID Функция VmbServerChannelInitSetTargetInterfaceId задает GUID типа целевого интерфейса и GUID экземпляра предложения канала.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL Функция VmbServerChannelInitSetTargetVtl задает целевой VTL для этого канала. Канал будет предлагаться клиентам, работающим в указанном VTL и не другим.
FN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE Функция VmbServerChannelInitSetVmbusHandle связывает экземпляр VMBus с этим каналом.

Структуры

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