Compartilhar via

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

  • Artigo

[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 VmbChannelInitSetProcessPacketCallbacks define funções de retorno de chamada para processamento de pacotes.

Sintaxe

FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS FnVmbChannelInitSetProcessPacketCallbacks;

NTSTATUS FnVmbChannelInitSetProcessPacketCallbacks(
  VMBCHANNEL Channel,
  PFN_VMB_CHANNEL_PROCESS_PACKET ProcessPacketCallback,
  PFN_VMB_CHANNEL_PROCESSING_COMPLETE ProcessingCompleteCallback
)
{...}

Parâmetros

Channel

Um identificador para o canal.

ProcessPacketCallback

Uma função de retorno de chamada a ser chamada quando um pacote estiver pronto para processamento.

ProcessingCompleteCallback

Uma função de retorno de chamada a ser chamada ao processar um lote de pacotes foi concluída.

Retornar valor

VmbChannelInitSetProcessPacketCallbacks retorna um dos seguintes valores de status:

Código de retorno Descrição
STATUS_SUCCESS
 A função foi concluída com êxito.
STATUS_INVALID_PARAMETER_1
 O valor channel era inválido ou em um estado inválido, como Desabilitado.

Comentários

Essa função só será significativa se o gerenciamento de filas da KMCL (Biblioteca de Clientes do Modo Kernel) não for suprimido.

ProcessPacketCallback é invocado para cada pacote recebido. EvtVmbChannelProcessingComplete será invocado sempre que o buffer de anel que contém pacotes de entrada passar de não vazio para vazio. Isso acontece após a última invocação de ProcessPacketCallback em um único lote.

Importante

Essa função é chamada por meio da interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus), fornecida pelo driver de barramento Vmbkmcl.sys. Essa é uma função cliente acessada da estrutura de KMCL_CLIENT_INTERFACE_V1 .

Para obter mais informações, consulte a seção Comentários do KMCL_CLIENT_INTERFACE_V1.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho vmbuskernelmodeclientlibapi.h

Confira também

EvtVmbChannelProcessingComplete

ProcessPacketCallback