EVT_VMB_CHANNEL_OPENED função de retorno de chamada (vmbuskernelmodeclientlibapi.h)
[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não faz garantias, expressas ou implícitas, em 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.
Valor de retorno
EvtVmbChannelClosed retorna um código de status.
Observações
Depois que um canal é criado, um driver 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 cliente retornar um código de status de falha, o canal reverterá para um estado em que nenhum tráfego flui.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | vmbuskernelmodeclientlibapi.h (inclua VmbusKernelModeClientLibApi.h) |
| IRQL | PASSIVE_LEVEL |