Compartilhar via

função de retorno de chamada FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA (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 VmbChannelInitSetMaximumExternalData define o tamanho máximo e o comprimento da cadeia de dados descritos por um pacote, mas não enviados diretamente no pacote. Ou seja, o tamanho máximo do buffer descrito por um ExternalDataMdl.

Sintaxe

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Parâmetros

Channel

Um ponteiro para um canal KMCL (Biblioteca de Clientes do Modo Kernel).

DataSize

O tamanho máximo dos dados externos.

ChainLength

O número máximo de MDLs (Listas de Descritor de Memória) em uma cadeia de MDL de entrada.

Retornar valor

VmbChannelInitSetMaximumExternalData pode retornar 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.
STATUS_INVALID_PARAMETER_2
 O valor DataSize é inválido. Zero (0) é inválido.
STATUS_INVALID_PARAMETER_3
 O valor ChainLength é inválido. Zero (0) é inválido.

Comentários

O KMCL garante que os buffers de anel sejam grandes o suficiente para enviar pacotes que contêm buffers nos limites especificados.

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