Encabezado vmbuskernelmodeclientlibapi.h

La red usa este encabezado. Para más información, consulte:

• Network

vmbuskernelmodeclientlibapi.h contiene las siguientes interfaces de programación:

Functions

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT La función VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT guarda las funciones de devolución de llamada que se usarán para los cambios de estado de un canal.

Funciones de devolución de llamada

EVT_VMB_CHANNEL_CLOSED La función de devolución de llamada EvtVmbChannelClosed se invoca cuando el punto de conexión de cliente de la máquina virtual invitada cierra un canal mediante la función VmbChannelDisable o el extremo opuesto vuelve a cerrar el canal.
EVT_VMB_CHANNEL_OPENED La función de devolución de llamada EvtVmbChannelOpened se invoca cuando el punto de conexión de cliente de la máquina virtual invitada abre un canal que se le ha ofrecido.
EVT_VMB_CHANNEL_PNP_FAILURE La función de devolución de llamada EvtChannelPnpFailure se invoca si el punto de conexión de cliente de la máquina virtual invitada no se puede conectar de forma asincrónica aunque se encuentre un dispositivo PnP.
EVT_VMB_CHANNEL_POST_STARTED La función de devolución de llamada EvtVmbChannelPostStarted se invoca en cualquier punto de conexión después de que se puedan recibir paquetes desde el punto de conexión opuesto.
EVT_VMB_CHANNEL_PROCESS_PACKET La función de devolución de llamada EvtVmbChannelProcessPacket se invoca cuando un paquete llega al búfer de anillo entrante.
EVT_VMB_CHANNEL_PROCESSING_COMPLETE La función de devolución de llamada EvtVmbChannelProcessingComplete se invoca cuando la función EvtVmbChannelProcessPacket entrega un grupo de paquetes, si hay una pausa antes de entregar paquetes posteriores.
EVT_VMB_CHANNEL_RESTORE_PACKET La función de devolución de llamada EvtVmbChannelRestorePacket se invoca cuando el punto de conexión del servidor del proveedor de servicios de virtualización (VSP) debe restaurar el estado asociado a un objeto de paquete.
EVT_VMB_CHANNEL_SAVE_PACKET La función de devolución de llamada EvtVmbChannelSavePacket se invoca cuando el punto de conexión del proveedor de servicios de virtualización (VSP) debe guardar el estado asociado a un paquete.
EVT_VMB_CHANNEL_STARTED La función de devolución de llamada EvtVmbChannelStarted se invoca en cualquier punto de conexión cuando un canal está completamente configurado, pero antes de que se entreguen los paquetes. Esto ocurre cuando el punto de conexión opuesto abrió el canal o lo volvió a abrir después de cerrarlo.
EVT_VMB_CHANNEL_SUSPEND La función de devolución de llamada EvtVmbChannelSuspend se invoca en el punto de conexión del servidor cuando el punto de conexión de cliente cierra o elimina el canal, que mueve el servidor al estado Detenido.
EVT_VMB_PACKET_COMPLETION_ROUTINE La función de devolución de llamada EvtVmbPacketCompletionRoutine se invoca cuando se completa la transacción asociada a un paquete enviado.
FN_VMB_CHANNEL_ALLOCATE La función VmbChannelAllocate asigna un nuevo canal VMBus que tiene parámetros predeterminados y devoluciones de llamada.
FN_VMB_CHANNEL_CLEANUP La función VmbChannelCleanup elimina un canal que se asignó mediante la función VmbChannelAllocate o inicializado mediante una función de inicialización del canal VMBus.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER La función VmbChannelCreateGpadlFromBuffer crea una lista de descriptores de direcciones físicas de invitado (GPADL) que describe un búfer del lado cliente. El GPADL se puede usar en el servidor para acceder al búfer.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL La función VmbChannelCreateGpadlFromMdl crea una lista de descriptores de direcciones físicas de invitado (GPADL) que describe un búfer del lado cliente. El GPADL se puede usar en el servidor para acceder al búfer.
FN_VMB_CHANNEL_DELETE_GPADL La función VmbChannelDeleteGpadl elimina una lista de descriptores de direcciones físicas de invitado (GPADL) asignada por las funciones VmbChannelCreateGpadlFromMdl o VmbChannelCreateGpadlFromBuffer.
FN_VMB_CHANNEL_DISABLE La función VmbChannelDisable deshabilita un canal, que lo cierra para los canales de cliente y revoca la oferta del canal para los canales de servidor. Esta función espera hasta que el canal se descomponga completamente antes de que se devuelva.
FN_VMB_CHANNEL_ENABLE La función VmbChannelEnable habilita un canal que está en estado deshabilitado conectando a VMBus y ofreciendo o abriendo un canal, según corresponda para el tipo de punto de conexión.
FN_VMB_CHANNEL_GET_INTERFACE_INSTANCE La función VmbChannelGetInterfaceInstance obtiene la instancia de interfaz activa, que es un GUID que identifica de forma única un canal.
FN_VMB_CHANNEL_GET_MMIO_SPACE La función VmbChannelGetMmioSpace recupera la dirección virtual del kernel del espacio MMIO asignado a un canal.
FN_VMB_CHANNEL_GET_POINTER La función VmbChannelGetPointer permite a un controlador de cliente recuperar un puntero que se guardó anteriormente mediante la función VmbPacketSetPointer.
FN_VMB_CHANNEL_INIT_SET_CLIENT_CONTEXT_SIZE La función VmbChannelInitSetClientContextSize establece el tamaño del área de contexto opcional asignada para el controlador de cliente en cada paquete entrante.
FN_VMB_CHANNEL_INIT_SET_FLAGS La función VmbChannelInitSetFlags establece marcas comunes a los puntos de conexión de canal de cliente o servidor.
FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME La función VmbChannelInitSetFriendlyName establece el nombre descriptivo del canal biblioteca cliente de modo kernel (KMCL). El nombre descriptivo se usa para la depuración y la nomenclatura de instancias del contador de rendimiento.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA La función VmbChannelInitSetMaximumExternalData establece el tamaño máximo y la longitud de cadena de los datos descritos por un paquete, pero no se envían directamente en el paquete. Es decir, el tamaño máximo del búfer descrito por externalDataMdl.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE La función VmbChannelInitSetMaximumPacketSize establece el tamaño máximo de paquete que se puede entregar a través de un canal, que es el tamaño máximo que siempre especificará la función VmbPacketSend.
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS La función VmbChannelInitSetProcessPacketCallbacks establece funciones de devolución de llamada para el procesamiento de paquetes.
FN_VMB_CHANNEL_INIT_SET_STATE_CHANGE_CALLBACKS La función VmbChannelInitSetStateChangeCallbacks establece funciones de devolución de llamada opcionales para los cambios de estado.
FN_VMB_CHANNEL_MAP_GPADL La función VmbChannelMapGpadl asigna un búfer del lado cliente al espacio de direcciones físicas del lado servidor mediante un número de lista de descriptores de direcciones físicas de invitado (GPADL).
FN_VMB_CHANNEL_PACKET_COMPLETE La función VmbChannelPacketComplete limpia las asignaciones de memoria pendientes, libera los búferes en uso y, si el extremo opuesto solicitó un paquete de finalización, envía un paquete de finalización.
FN_VMB_CHANNEL_PACKET_DEFER_TO_PASSIVE El controlador cliente llama a la función VmbChannelPacketDeferToPassive para aplazar un paquete pasado por la función de devolución de llamada EvtVmbChannelProcessPacket.
FN_VMB_CHANNEL_PACKET_FAIL La función VmbChannelPacketFail produce un error en un paquete durante el procesamiento de paquetes debido a un error irrecuperable. Esta función detiene la cola.
FN_VMB_CHANNEL_PACKET_GET_EXTERNAL_DATA La función VmbChannelPacketGetExternalData obtiene todas las listas de descriptores de memoria (MDL) externas asociadas a un paquete durante el procesamiento de paquetes.
FN_VMB_CHANNEL_PAUSE La función VmbChannelPause mueve un canal al estado en pausa, lo que impide la nueva E/S.
FN_VMB_CHANNEL_RESTORE_FROM_BUFFER La función VmbChannelRestoreFromBuffer restaura el estado del cliente a partir del estado guardado anteriormente. El controlador debe comprobar el valor devuelto de la función.
FN_VMB_CHANNEL_SAVE_BEGIN La función VmbChannelSaveBegin inicializa el contexto para guardar el estado de un canal. El controlador debe comprobar el valor devuelto de la función.
FN_VMB_CHANNEL_SAVE_CONTINUE La función VmbChannelSaveContinue guarda el estado del canal en un búfer. Ejecute VmbChannelSaveBegin antes de ejecutar esta función. El controlador debe comprobar el valor devuelto de la función.
FN_VMB_CHANNEL_SAVE_END La función VmbChannelSaveEnd limpia los recursos que se asignaron para guardar el estado de un canal.
FN_VMB_CHANNEL_SEND_SYNCHRONOUS_REQUEST La función VmbChannelSendSynchronousRequest envía un paquete al punto de conexión opuesto y espera una respuesta.
FN_VMB_CHANNEL_SET_INCOMING_PROCESSING_AT_PASSIVE La función VmbChannelSetIncomingProcessingAtPassive establece la IRQL necesaria para las rutinas de análisis entrantes de un canal en PASSIVE_LEVEL.
FN_VMB_CHANNEL_SET_INTERRUPT_LATENCY La máquina virtual invitada se actualiza a la latencia de supervisión saliente para las interrupciones de MNF.
FN_VMB_CHANNEL_SET_POINTER La función VmbChannelSetPointer guarda un puntero arbitrario en un contexto de canal.
FN_VMB_CHANNEL_SET_TRANSACTION_QUOTA La función VmbChannelSetTransactionQuota establece la cuota de paquetes entrantes.
FN_VMB_CHANNEL_SIZEOF_PACKET La función VmbChannelSizeofPacket calcula el tamaño necesario para que los búferes se usen con la función VmbPacketInitialize.
FN_VMB_CHANNEL_START La función VmbChannelStart mueve un canal fuera del estado en pausa.
FN_VMB_CHANNEL_UNMAP_GPADL La función VmbChannelUnmapGpadl desasigna una lista de descriptores de direcciones físicas de invitado (GPADL) asignada mediante la función VmbChannelMapGpadl. El servidor ya no debe usar el búfer antes de llamar a esta función.
FN_VMB_CLIENT_CHANNEL_INIT_SET_RING_BUFFER_PAGE_COUNT La función VmbClientChannelInitSetRingBufferPageCount establece el número de páginas de memoria que el cliente asigna para los búferes de anillo entrante y saliente.
FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP La función VmbClientChannelInitSetTargetPnp establece el destino de un canal de cliente por tipo de interfaz e identificadores de instancia.
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE La función VmbConvertVmbusHandleToKernelHandle convierte el identificador VMBus del modo de usuario en el identificador del modo kernel.
FN_VMB_PACKET_ALLOCATE La función VmbPacketAllocate asigna un paquete de la lista de lookaside del canal.
FN_VMB_PACKET_FREE La función VmbPacketFree libera un paquete asignado mediante la función VmbPacketAllocate.
FN_VMB_PACKET_GET_CHANNEL La función VmbPacketGetChannel devuelve el canal VMBus con el que está asociado un paquete VMBus.
FN_VMB_PACKET_GET_POINTER La función VmbPacketGetPointer recupera un puntero que se guardó anteriormente mediante la función VmbPacketSetPointer.
FN_VMB_PACKET_INITIALIZE La función VmbPacketInitialize inicializa un búfer para que contenga un paquete VMBus.
FN_VMB_PACKET_RESTORE La función VmbPacketRestore restaura el paquete de un búfer que contiene el contexto de paquete guardado.
FN_VMB_PACKET_SEND La función VmbPacketSend envía los datos en un búfer de paquetes o en una lista de descriptores de memoria de datos externos (MDL). La función asocia esos datos con el objeto de paquete VMBus, que representa el paquete durante toda la duración de la transacción.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL La función VmbPacketSendWithExternalMdl envía los datos en un búfer de paquetes o en una lista de descriptores de memoria de datos externos (MDL).
FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS La función VmbPacketSendWithExternalPfns envía los datos en un búfer de paquetes o datos externos como una matriz de números de fotogramas de página (PFN).
FN_VMB_PACKET_SET_COMPLETION_ROUTINE La función VmbPacketSetCompletionRoutine establece la rutina de finalización de un objeto de paquete.
FN_VMB_PACKET_SET_POINTER La función VmbPacketSetPointer guarda un puntero arbitrario en el contexto del paquete.
FN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS La función VmbServerChannelInitSetFlags establece marcas únicas para los puntos de conexión del canal de servidor.
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES La función VmbServerChannelInitSetMmioMegabytes especifica la cantidad, megabytes, del espacio de E/S asignado a memoria de invitado (MMIO) que se va a reservar para el dispositivo.
FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS La función VmbServerChannelInitSetSaveRestorePacketCallbacks establece las funciones de devolución de llamada para guardar y restaurar que se llaman para cada paquete cuando el controlador llama a una función save, como VmbChannelSaveBegin, VmbChannelSaveContinue y VmbChannelSaveEnd, o la función VmbChannelRestoreFromBuffer.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID La función VmbServerChannelInitSetTargetInterfaceId establece el GUID de tipo de interfaz de destino y el GUID de instancia de la oferta del canal.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL La función VmbServerChannelInitSetTargetVtl establece el VTL de destino para este canal. El canal se ofrecerá a los clientes que se ejecutan en el VTL especificado y a ningún otro.
FN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE La función VmbServerChannelInitSetVmbusHandle asocia una instancia de VMBus a este canal.

Estructuras

KMCL_SERVER_ONLY_METHODS La estructura KMCL_SERVER_ONLY_METHODS contiene punteros de función para funciones solo de servidor para la interfaz de la biblioteca cliente del modo kernel (KMCL) de VMBus.
KMCL_SERVER_ONLY_METHODS_V5 La estructura KMCL_CLIENT_INTERFACE_V1 contiene punteros de función para las funciones de cliente para la interfaz de la biblioteca cliente del modo kernel de VMBus (KMCL).
VMB_CHANNEL_STATE_CHANGE_CALLBACKS La estructura VMB_CHANNEL_STATE_CHANGE_CALLBACKS contiene funciones de devolución de llamada relacionadas con los cambios de estado de un canal.