Compartilhar via


função de retorno de chamada EVT_VMB_CHANNEL_OPENED (vmbuskernelmodeclientlibapi.h)

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

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.

Sintaxe

EVT_VMB_CHANNEL_OPENED EvtVmbChannelOpened;

NTSTATUS EvtVmbChannelOpened(
  [in] VMBCHANNEL Channel
)
{...}

Parâmetros

[in] Channel

O canal que a máquina virtual convidada abre.

Retornar valor

EvtVmbChannelClosed retorna um código status.

Comentários

Depois que um canal é criado, um driver de cliente pode especificar funções de retorno de chamada para alterações de estado, incluindo EvtVmbChannelOpened, usando a função VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT .

Depois que um canal tiver sido
configurado, o cliente KMCL (Biblioteca de Clientes do Modo Kernel) chama a função VmbChannelEnable . No host, essa função oferece um canal para o convidado. No convidado, essa função aceita uma oferta existente ou aguarda a chegada dessa oferta. Quando um canal é aberto, o KMCL invoca a função de retorno de chamada EvtVmbChannelOpened .
Depois que esse retorno de chamada for concluído, o canal estará no estado aberto.

Antes que essa função de retorno de chamada seja invocada, os pacotes podem ser enfileirados, mas não podem ser enviados.

Se o driver do cliente retornar uma falha status código, o canal reverterá para um estado em que nenhum tráfego flui.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho vmbuskernelmodeclientlibapi.h (inclua VmbusKernelModeClientLibApi.h)
IRQL PASSIVE_LEVEL

Confira também

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT

VmbChannelEnable