função de retorno de chamada FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA (vmbuskernelmodeclientlibapi.h)
[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 |
|---|---|
|
A função foi concluída com êxito. |
|
O valor channel era inválido ou em um estado inválido, como Desabilitado. |
|
O valor DataSize é inválido. Zero (0) é inválido. |
|
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 |