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 |
|---|---|
|
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 |