FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES función de devolución de llamada (vmbuskernelmodeclientlibapi.h)

  • Artículo

La función VmbServerChannelInitSetMmioMegabytes especifica la cantidad, megabytes, del espacio de E/S asignado a memoria de invitado (MMIO) que se va a reservar para el dispositivo.

Sintaxis

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

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

Parámetros

Channel

Identificador de un canal.

MmioMegabytes

Cantidad de espacio MMIO, en megabytes, que se va a reservar.

MmioMegabytesOptional

Cantidad de espacio MMIO adicional opcional, en megabytes, que se va a reservar.

Valor devuelto

VmbServerChannelInitSetMmioMegabytes devuelve los siguientes valores de estado:

Código devuelto Descripción
STATUS_INVALID_PARAMETER_1
 El valor del canal no era válido o estaba en un estado no válido, como Deshabilitado.
STATUS_INVALID_PARAMETER
 Tanto MmioMegabytes como MmioMegabytesOptional tienen un valor de cero (0). Uno de estos parámetros debe ser mayor que cero

Comentarios

Esta función existe como una comodidad para los creadores de controladores. Todo lo que hace podría hacerse mediante la interacción con el administrador de E/S asignado a la memoria y la solicitud de espacio de E/S asignado a la memoria directamente. Es un requisito común que los controladores VMBus de Windows y Linux tengan la capacidad de reservar espacio MMIO en nombre del cliente. Esta función permite al punto de conexión del servidor sugerir la cantidad correcta de espacio MMIO que se va a reservar.

Importante

Esta función se llama a través de la interfaz de la biblioteca cliente del modo kernel de VMBus (KMCL), proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función de solo servidor a la que se accede desde la estructura de KMCL_SERVER_ONLY_METHODS .

Para obtener más información, vea la sección Comentarios de KMCL_SERVER_ONLY_METHODS.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809
Encabezado vmbuskernelmodeclientlibapi.h