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

Artigo
02/07/2025

[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 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 Descritores de Memória) em uma cadeia de MDL de entrada.

Valor de retorno

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 do Canal 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.

Observações

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
de cliente com suporte mínimo	Windows 10, versão 1803
cabeçalho	vmbuskernelmodeclientlibapi.h

Compartilhar via