FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS 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 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.

Valor de retorno

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 do Canal era inválido ou em um estado inválido, como Desabilitado.

Observações

Essa função só será significativa se o gerenciamento de filas 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
de cliente com suporte mínimo	Windows 10, versão 1803
cabeçalho	vmbuskernelmodeclientlibapi.h

Consulte também

EvtVmbChannelProcessingComplete

ProcessPacketCallback