Partition Save and Restore Data Types

The data types that the hypervisor defines for saving and restoring partitions are described in the following sections:

Partition Save and Restore State

A caller might be required to call the HvSavePartitionState and HvRestorePartitionState hypercall functions several times in succession until the complete state has either been returned (save) or restored (restore). With each call, the hypervisor returns a separate status that represents the overall state of the save or restore operation. The status provides feedback that concerns the save or restore process and is used to indicate completion, interim success (incomplete), or an error. The errors indicate that continuation is not possible and why. The hypervisor uses values from the HV_SAVE_RESTORE_STATE_RESULT enumeration to indicate the status of the process of save and restore operations.

Save and Restore Partition State Flags

A caller uses the following flags with the HvSavePartitionState and HvRestorePartitionState hypercall functions:

typedef UINT32 HV_SAVE_RESTORE_STATE_FLAGS;

#define HV_SAVE_RESTORE_STATE_START  0x00000001
#define HV_SAVE_RESTORE_STATE_SUMMARY  0x00000002

A caller must use the flag HV_SAVE_RESTORE_STATE_START in the first call to the HvSavePartitionState or HvRestorePartitionState hypercall function to begin a save or restore process. Subsequent calls to HvSavePartitionState or HvRestorePartitionState should not specify this flag unless the caller is prematurely terminating a save or restore process. In this situation, the caller uses this flag to ensure that all intervening save or restore context that is maintained by the hypervisor is released.

A caller uses the flag HV_SAVE_RESTORE_STATE_SUMMARY to indicate that the save data is summary data and not complete partition save data. For more information about summary data, see Summary State.

A caller can use both the HV_SAVE_RESTORE_STATE_START and HV_SAVE_RESTORE_STATE_SUMMARY flags in the same call to HvSavePartitionState or HvRestorePartitionState.

Send comments about this topic to Microsoft

Build date: 11/16/2013