Cabeçalho vmbuskernelmodeclientlibapi.h

Esse cabeçalho é usado pela rede. Para obter mais informações, consulte:

• Rede

vmbuskernelmodeclientlibapi.h contém as seguintes interfaces de programação:

Funções

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT A função VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT salva funções de retorno de chamada a serem usadas para alterações de estado para um canal.

Funções de retorno de chamada

EVT_VMB_CHANNEL_CLOSED A função de retorno de chamada EvtVmbChannelClosed é invocada quando o ponto de extremidade do cliente na máquina virtual convidada fecha um canal usando a função VmbChannelDisable ou o ponto de extremidade oposto rescinde ou fecha o canal.
EVT_VMB_CHANNEL_OPENED A função de retorno de chamada EvtVmbChannelOpened é invocada quando o ponto de extremidade do cliente na máquina virtual convidada abre um canal que foi oferecido a ela.
EVT_VMB_CHANNEL_PNP_FAILURE A função de retorno de chamada EvtChannelPnpFailure será invocada se o ponto de extremidade do cliente na máquina virtual convidada falhar de forma assíncrona ao se conectar, mesmo que um dispositivo PnP esteja localizado.
EVT_VMB_CHANNEL_POST_STARTED A função de retorno de chamada EvtVmbChannelPostStarted é invocada em ambos os pontos de extremidade depois que os pacotes podem ser recebidos do ponto de extremidade oposto.
EVT_VMB_CHANNEL_PROCESS_PACKET A função de retorno de chamada EvtVmbChannelProcessPacket é invocada quando um pacote chega no buffer de anel de entrada.
EVT_VMB_CHANNEL_PROCESSING_COMPLETE A função de retorno de chamada EvtVmbChannelProcessingComplete é invocada quando um grupo de pacotes é entregue pela função EvtVmbChannelProcessPacket, se houver uma pausa antes de entregar pacotes subsequentes.
EVT_VMB_CHANNEL_RESTORE_PACKET A função de retorno de chamada EvtVmbChannelRestorePacket é invocada quando o ponto de extremidade do servidor VSP (provedor de serviços de virtualização) deve restaurar o estado associado a um objeto de pacote.
EVT_VMB_CHANNEL_SAVE_PACKET A função de retorno de chamada EvtVmbChannelSavePacket é invocada quando o ponto de extremidade do VSP (provedor de serviços de virtualização) deve salvar o estado associado a um pacote.
EVT_VMB_CHANNEL_STARTED A função de retorno de chamada EvtVmbChannelStarted é invocada em ambos os pontos de extremidade quando um canal está totalmente configurado, mas antes de qualquer pacote ter sido entregue. Isso ocorre quando o ponto de extremidade oposto abriu o canal ou o reabriu após fechá-lo.
EVT_VMB_CHANNEL_SUSPEND A função de retorno de chamada EvtVmbChannelSuspend é invocada no ponto de extremidade do servidor quando o canal está sendo fechado ou excluído pelo ponto de extremidade do cliente, que move o servidor para o estado Parado.
EVT_VMB_PACKET_COMPLETION_ROUTINE A função de retorno de chamada EvtVmbPacketCompletionRoutine é invocada quando a transação associada a um pacote enviado é concluída.
FN_VMB_CHANNEL_ALLOCATE A função VmbChannelAllocate aloca um novo canal VMBus que tem parâmetros padrão e retornos de chamada.
FN_VMB_CHANNEL_CLEANUP A função VmbChannelCleanup descarta um canal que foi alocado usando a função VmbChannelAllocate ou inicializado usando uma função de inicialização de canal VMBus.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER A função VmbChannelCreateGpadlFromBuffer cria uma GPADL (Lista de Descritores de Endereço Físico Convidado) que descreve um buffer do lado do cliente. O GPADL pode ser usado no servidor para acessar o buffer.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL A função VmbChannelCreateGpadlFromMdl cria uma GPADL (Lista de Descritores de Endereço Físico Convidado) que descreve um buffer do lado do cliente. O GPADL pode ser usado no servidor para acessar o buffer.
FN_VMB_CHANNEL_DELETE_GPADL A função VmbChannelDeleteGpadl exclui uma GPADL (Lista de Descritores de Endereço Físico Convidado) mapeada pelas funções VmbChannelCreateGpadlFromMdl ou VmbChannelCreateGpadlFromBuffer.
FN_VMB_CHANNEL_DISABLE A função VmbChannelDisable desabilita um canal, que o fecha para canais cliente e revoga a oferta de canal para canais de servidor. Essa função aguarda até que o canal seja completamente dividido antes de retornar.
FN_VMB_CHANNEL_ENABLE A função VmbChannelEnable habilita um canal que está no estado desabilitado conectando-se ao VMBus e oferecendo ou abrindo um canal, conforme apropriado para o tipo de ponto de extremidade.
FN_VMB_CHANNEL_GET_INTERFACE_INSTANCE A função VmbChannelGetInterfaceInstance obtém a instância de interface ativa, que é um GUID que identifica exclusivamente um canal.
FN_VMB_CHANNEL_GET_MMIO_SPACE A função VmbChannelGetMmioSpace recupera o endereço virtual do kernel do espaço MMIO alocado a um canal.
FN_VMB_CHANNEL_GET_POINTER A função VmbChannelGetPointer permite que um driver de cliente recupere um ponteiro que foi salvo anteriormente usando a função VmbPacketSetPointer.
FN_VMB_CHANNEL_INIT_SET_CLIENT_CONTEXT_SIZE A função VmbChannelInitSetClientContextSize define o tamanho da área de contexto opcional alocada para o driver cliente em cada pacote de entrada.
FN_VMB_CHANNEL_INIT_SET_FLAGS A função VmbChannelInitSetFlags define sinalizadores comuns aos pontos de extremidade do servidor ou do canal cliente.
FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME A função VmbChannelInitSetFriendlyName define o nome amigável do canal KMCL (Biblioteca de Clientes do Modo Kernel). O nome amigável é usado para depuração e nomenclatura de instância do contador de desempenho.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA A função VmbChannelInitSetMaximumExternalData define o tamanho máximo e o comprimento da cadeia de dados descritos por um pacote, mas não enviados diretamente no pacote. Ou seja, o tamanho máximo do buffer descrito por um ExternalDataMdl.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE A função VmbChannelInitSetMaximumPacketSize define o tamanho máximo do pacote que pode ser entregue por meio de um canal, que é o tamanho máximo que será especificado pela função VmbPacketSend.
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS A função VmbChannelInitSetProcessPacketCallbacks define funções de retorno de chamada para processamento de pacotes.
FN_VMB_CHANNEL_INIT_SET_STATE_CHANGE_CALLBACKS A função VmbChannelInitSetStateChangeCallbacks define funções opcionais de retorno de chamada para alterações de estado.
FN_VMB_CHANNEL_MAP_GPADL A função VmbChannelMapGpadl mapeia um buffer do lado do cliente para o espaço de endereço físico do lado do servidor usando um número GPADL (Lista de Descritores de Endereço Físico Convidado).
FN_VMB_CHANNEL_PACKET_COMPLETE A função VmbChannelPacketComplete limpa todos os mapeamentos de memória pendentes, libera todos os buffers em uso e, se o ponto de extremidade oposto solicitou um pacote de conclusão, envia um pacote de conclusão.
FN_VMB_CHANNEL_PACKET_DEFER_TO_PASSIVE A função VmbChannelPacketDeferToPassive é chamada pelo driver do cliente para adiar um pacote passado para ele pela função de retorno de chamada EvtVmbChannelProcessPacket.
FN_VMB_CHANNEL_PACKET_FAIL A função VmbChannelPacketFail falha em um pacote durante o processamento de pacotes devido a um erro irrecuperável. Essa função interrompe a fila.
FN_VMB_CHANNEL_PACKET_GET_EXTERNAL_DATA A função VmbChannelPacketGetExternalData obtém quaisquer MDLs (Listas de Descritores de Memória) externas associadas a um pacote durante o processamento de pacotes.
FN_VMB_CHANNEL_PAUSE A função VmbChannelPause move um canal para o estado em pausa, o que impede a nova E/S.
FN_VMB_CHANNEL_RESTORE_FROM_BUFFER A função VmbChannelRestoreFromBuffer restaura o estado do cliente do estado salvo anteriormente. O driver deve marcar o valor retornado da função.
FN_VMB_CHANNEL_SAVE_BEGIN A função VmbChannelSaveBegin inicializa o contexto para salvar o estado de um canal. O driver deve marcar o valor retornado da função.
FN_VMB_CHANNEL_SAVE_CONTINUE A função VmbChannelSaveContinue salva o estado do canal em um buffer. Execute o VmbChannelSaveBegin antes de executar essa função. O driver deve marcar o valor retornado da função.
FN_VMB_CHANNEL_SAVE_END A função VmbChannelSaveEnd limpa todos os recursos alocados para salvar o estado de um canal.
FN_VMB_CHANNEL_SEND_SYNCHRONOUS_REQUEST A função VmbChannelSendSynchronousRequest envia um pacote para o ponto de extremidade oposto e aguarda uma resposta.
FN_VMB_CHANNEL_SET_INCOMING_PROCESSING_AT_PASSIVE A função VmbChannelSetIncomingProcessingAtPassive define o IRQL necessário para rotinas de análise de entrada para um canal PASSIVE_LEVEL.
FN_VMB_CHANNEL_SET_INTERRUPT_LATENCY Atualizações de VM convidada para a latência do monitor de saída para interrupções MNF.
FN_VMB_CHANNEL_SET_POINTER A função VmbChannelSetPointer salva um ponteiro arbitrário em um contexto de canal.
FN_VMB_CHANNEL_SET_TRANSACTION_QUOTA A função VmbChannelSetTransactionQuota define a cota de pacotes de entrada.
FN_VMB_CHANNEL_SIZEOF_PACKET A função VmbChannelSizeofPacket calcula o tamanho necessário para que os buffers sejam usados com a função VmbPacketInitialize.
FN_VMB_CHANNEL_START A função VmbChannelStart move um canal para fora do estado em pausa.
FN_VMB_CHANNEL_UNMAP_GPADL A função VmbChannelUnmapGpadl desmapea uma GPADL (Lista de Descritores de Endereço Físico Convidado) mapeada usando a função VmbChannelMapGpadl. O buffer não deve mais estar em uso pelo servidor antes que essa função seja chamada.
FN_VMB_CLIENT_CHANNEL_INIT_SET_RING_BUFFER_PAGE_COUNT A função VmbClientChannelInitSetRingBufferPageCount define o número de páginas de memória alocadas pelo cliente para buffers de anéis de entrada e saída.
FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP A função VmbClientChannelInitSetTargetPnp define o destino de um canal cliente por tipo de interface e IDs de instância.
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE A função VmbConvertVmbusHandleToKernelHandle converte o identificador VMBus do modo de usuário em identificador de modo kernel.
FN_VMB_PACKET_ALLOCATE A função VmbPacketAllocate aloca um pacote da lista lookaside do canal.
FN_VMB_PACKET_FREE A função VmbPacketFree libera um pacote alocado usando a função VmbPacketAllocate.
FN_VMB_PACKET_GET_CHANNEL A função VmbPacketGetChannel retorna o canal VMBus ao qual um pacote VMBus está associado.
FN_VMB_PACKET_GET_POINTER A função VmbPacketGetPointer recupera um ponteiro que foi salvo anteriormente usando a função VmbPacketSetPointer.
FN_VMB_PACKET_INITIALIZE A função VmbPacketInitialize inicializa um buffer para conter um pacote VMBus.
FN_VMB_PACKET_RESTORE A função VmbPacketRestore restaura o pacote de um buffer que contém o contexto de pacote salvo.
FN_VMB_PACKET_SEND A função VmbPacketSend envia os dados em um buffer de pacotes ou MDL (Lista de Descritores de Memória) de dados externos. A função associa esses dados ao objeto de pacote VMBus, que representa o pacote durante todo o tempo de vida da transação.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL A função VmbPacketSendWithExternalMdl envia os dados em um buffer de pacotes ou MDL (Lista de Descritores de Memória) de dados externos.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS A função VmbPacketSendWithExternalPfns envia os dados em um buffer de pacotes ou dados externos como uma matriz de PFNs (Números de Quadro de Página).
FN_VMB_PACKET_SET_COMPLETION_ROUTINE A função VmbPacketSetCompletionRoutine define a rotina de conclusão de um objeto de pacote.
FN_VMB_PACKET_SET_POINTER A função VmbPacketSetPointer salva um ponteiro arbitrário no contexto do pacote.
FN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS A função VmbServerChannelInitSetFlags define sinalizadores exclusivos para pontos de extremidade de canal do servidor.
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES A função VmbServerChannelInitSetMmioMegabytes especifica a quantidade, megabytes, do espaço MMIO (E/S mapeado na memória do convidado) a ser reservado para o dispositivo.
FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS A função VmbServerChannelInitSetSaveRestorePacketCallbacks define as funções de retorno de chamada de salvamento e restauração que são chamadas para cada pacote quando o driver chama uma função save, como VmbChannelSaveBegin, VmbChannelSaveContinue e VmbChannelSaveEnd ou a função VmbChannelRestoreFromBuffer.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID A função VmbServerChannelInitSetTargetInterfaceId define o GUID do tipo de interface de destino e o GUID da instância da oferta de canal.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL A função VmbServerChannelInitSetTargetVtl define o VTL de destino para este canal. O canal será oferecido aos clientes em execução na VTL especificada e a nenhum outro.
FN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE A função VmbServerChannelInitSetVmbusHandle associa uma instância do VMBus a esse canal.

Estruturas

KMCL_SERVER_ONLY_METHODS A estrutura KMCL_SERVER_ONLY_METHODS contém ponteiros de função para funções somente de servidor para a interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus).
KMCL_SERVER_ONLY_METHODS_V5 A estrutura KMCL_CLIENT_INTERFACE_V1 contém ponteiros de função para funções de cliente para a interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus).
VMB_CHANNEL_STATE_CHANGE_CALLBACKS A estrutura VMB_CHANNEL_STATE_CHANGE_CALLBACKS contém funções de retorno de chamada relacionadas às alterações de estado de um canal.