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 |
|---|---|
|
O valor canal era inválido ou em um estado inválido, como Desabilitado. |
|
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 |