EVT_VMB_CHANNEL_STARTED función de devolución de llamada (vmbuskernelmodeclientlibapi.h)

Artículo
08/08/2023

[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

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 hayan entregado paquetes. Esto ocurre cuando el punto de conexión opuesto abrió el canal o lo volvió a abrir después de cerrarlo.

Sintaxis

EVT_VMB_CHANNEL_STARTED EvtVmbChannelStarted;

void EvtVmbChannelStarted(
  [in] VMBCHANNEL Channel
)
{...}

Parámetros

[in] Channel

Canal que se inicia.

Valor devuelto

None

Observaciones

Una vez creado un canal, un controlador cliente puede especificar funciones de devolución de llamada para los cambios de estado, incluido EvtVmbChannelStarted, mediante la función VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT .

Si se abre un canal en pausa o se inicia un canal abierto, la Biblioteca cliente del modo kernel (KMCL) llama a EvtVmbChannelStarted después de llamar a la devolución de llamada EvtVmbChannelOpened . EvtVmbChannelStarted puede llamar a las funciones VmbPacketSend, VmbPacketSendWithExternalMdl y VmbPacketSendWithExternalPfns para poner en cola paquetes salientes. Dado que la cola entrante no se está ejecutando en este momento, esta devolución de llamada no debe bloquearse en paquetes entrantes ni finalizaciones.

La mayoría de los controladores que usan KMCL no implementan esta devolución de llamada. Una alternativa es la función de devolución de llamada EvtVmbChannelPostStarted .

Esperando a que se complete un paquete enviado, como por la función VmbChannelSendSynchronousRequest , nunca devuelve porque los paquetes no fluyen cuando se invoca esta devolución de llamada.