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

[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

La función VmbChannelMapGpadl asigna un búfer del lado cliente al espacio de direcciones físicas del lado servidor mediante un número de lista de descriptores de direcciones físicas de invitado (GPADL).

Sintaxis

FN_VMB_CHANNEL_MAP_GPADL FnVmbChannelMapGpadl;

NTSTATUS FnVmbChannelMapGpadl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  UINT32 GpadlHandle,
  PMDL *Mdl
)
{...}

Parámetros

Channel

Identificador de un canal.

Flags

Banderas. Los valores de marca posibles son:

Valor	Significado
VMBUS_CHANNEL_GPADL_FLAG_READ_ONLY	Asignación con acceso de solo lectura.

 

Si no se establece este valor de marca, la función intenta asignar el GPADL para el acceso de escritura. Si el GPADL no se creó con acceso de escritura, se produce un error en este intento de asignación. No se impide que el autor de la llamada escriba en el búfer si se establece esta marca. Este esquema se usa para mejorar el rendimiento de la migración en vivo y la creación de instantáneas.

GpadlHandle

Identificador GPADL del GPADL que se va a asignar.

Mdl

Puntero a una MDL que describe el búfer de cliente. Este búfer solo se asigna al espacio de direcciones físico. El autor de la llamada debe realizar pasos adicionales para asignarlo al espacio de direcciones virtuales.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente o un código de error NTSTATUS adecuado de lo contrario.

Comentarios

El cliente debe haber establecido previamente el GPADL, por ejemplo, mediante la función VmbChannelCreateGpadlFromBuffer .

Solo puede existir una sola asignación para cualquier GPADL determinado a la vez.

Debe emparejar las llamadas a esta función con llamadas a la función VmbChannelUnmapGpadl .

Importante

Esta función se llama a través de la interfaz biblioteca cliente del modo kernel (KMCL) de VMBus, 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 1803
Encabezado	vmbuskernelmodeclientlibapi.h

Consulte también

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl