FN_VMB_CHANNEL_MAP_GPADL callback function (vmbuskernelmodeclientlibapi.h)

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The VmbChannelMapGpadl function maps a client-side buffer into server-side physical address space by using a Guest Physical Address Descriptor List (GPADL) number.

Syntax

FN_VMB_CHANNEL_MAP_GPADL FnVmbChannelMapGpadl;

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

Parameters

Channel

A handle for a channel.

Flags

Flags. The possible flag values are:

If this flag value is not set, the function tries to map the GPADL for write access. If the GPADL was not created with write access, this mapping attempt fails. The caller is not prevented from writing to the buffer if this flag is set. This scheme is used to improve the performance of live migration and snapshotting.

GpadlHandle

The GPADL handle of the GPADL to map.

Mdl

A pointer to a MDL describing the client buffer. This buffer is only mapped into physical address space. The caller must take additional steps to map it into virtual address space.

Return value

Returns STATUS_SUCCESS if the operation succeeds, or an appropriate NTSTATUS error code otherwise.

Remarks

The GPADL must have been pre-established by the client, for instance, by using the VmbChannelCreateGpadlFromBuffer function.

Only a single mapping may exist for any given GPADL at a time.

You must pair calls to this function with calls to the VmbChannelUnmapGpadl function.

Requirements

See also

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl