Compartilhar via


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

A função VmbServerChannelInitSetMmioMegabytes especifica a quantidade, megabytes, do espaço MMIO (E/S mapeado na memória do convidado) 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 MMIO adicional opcional, em megabytes, a ser reservada.

Retornar valor

VmbServerChannelInitSetMmioMegabytes retorna os seguintes valores de status:

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

Comentários

Essa função existe como uma conveniência para criadores de driver. Tudo o que ele faz pode ser feito interagindo o com o gerenciador de plug-and-play convidado e solicitando espaço de E/S mapeado na memória diretamente. É um requisito comum que os drivers VMBus do Windows e do 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 reservar.

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