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

Artigo
02/07/2025

A função VmbServerChannelInitSetMmioMegabytes especifica a quantidade, megabytes, do espaço de E/S mapeado pela memória do convidado (MMIO) a ser reservado para o dispositivo.

Sintaxe

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
  VMBCHANNEL Channel,
  UINT16 MmioMegabytes,
  UINT16 MmioMegabytesOptional
)
{...}

Parâmetros

Channel

Um identificador para um canal.

MmioMegabytes

A quantidade de espaço MMIO, em megabytes, a ser reservada.

MmioMegabytesOptional

A quantidade de espaço adicional opcional do MMIO, em megabytes, a ser reservada.

Valor de retorno

VmbServerChannelInitSetMmioMegabytes retorna os seguintes valores de status:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER_1	O valor do Canal era inválido ou em um estado inválido, como Desabilitado.
STATUS_INVALID_PARAMETER	Ambos MmioMegabytes e MmioMegabytesOptional têm um valor igual a zero (0). Um desses parâmetros deve ser maior que zero

Observações

Essa função existe como uma conveniência para criadores de driver. Tudo o que ele faz pode ser feito interagindo com o gerenciador de plug-and-play convidado e solicitando espaço de E/S mapeado pela memória diretamente. É um requisito comum que os drivers VMBus do Windows e linux tenham a capacidade de reservar espaço MMIO em nome do cliente. Essa função permite que o ponto de extremidade do servidor sugira a quantidade certa de espaço MMIO a ser reservado.

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 somente servidor acessada da estrutura KMCL_SERVER_ONLY_METHODS.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1809
cabeçalho	vmbuskernelmodeclientlibapi.h

Partilhar via