HV_SAVE_RESTORE_STATE_RESULT enumeration

The HV_SAVE_RESTORE_STATE_RESULT enumeration contains the status feedback of a save or restore operation.

Syntax

typedef enum _HV_SAVE_RESTORE_STATE_RESULT { 
  HvStateComplete                                     = 0,
  HvStateIncomplete                                   = 1,
  HvStateRestorable                                   = 2,
  HvStateCorruptData                                  = 3,
  HvStateUnsupportedVersion                           = 4,
  HvStateProcessorFeatureMismatch                     = 5,
  HvStateHardwareFeatureMismatch                      = 6,
  HvStateProcessorCountMismatch                       = 7,
  HvStateProcessorFlagsMismatch                       = 8,
  HvStateProcessorIndexMismatch                       = 9,
  HvStateProcessorInsufficientMemory                  = 10,
  HvStateIncompatibleProcessor                        = 11,
  HvStateProcessorFeatureSse3Mismatch                 = 12,
  HvStateProcessorFeatureLahfSahfMismatch             = 13,
  HvStateProcessorFeaturSsse3eMismatch                = 14,
  HvStateProcessorFeatureSse41Mismatch                = 15,
  HvStateProcessorFeatureSse42Mismatch                = 16,
  HvStateProcessorFeatureSse4aMismatch                = 17,
  HvStateProcessorFeatureSse5Mismatch                 = 18,
  HvStateProcessorFeaturePopcntMismatch               = 19,
  HvStateProcessorFeatureCmpxchg16bMismatch           = 20,
  HvStateProcessorFeatureAltmovcr8Mismatch            = 21,
  HvStateProcessorFeatureLzcntMismatch                = 22,
  HvStateProcessorFeatureMisalignedSseMismatch        = 23,
  HvStateProcessorFeatureMmxExtMismatch               = 24,
  HvStateProcessorFeature3DNowMismatch                = 25,
  HvStateProcessorFeatureExtended3DNowMismatch        = 26,
  HvStateProcessorFeaturePage1GBMismatch              = 27,
  HvStateProcessorCacheLineFlushSizeMismatch          = 28,
  HvStateProcessorFeatureXsaveMismatch                = 29,
  HvStateProcessorFeatureXsaveoptMismatch             = 30,
  HvStateProcessorFeatureXsaveLegacySseMismatch       = 31,
  HvStateProcessorFeatureXsaveAvxMismatch             = 32,
  HvStateProcessorFeatureXsaveUnknownFeatureMismatch  = 33,
  HvStateProcessorXsaveSaveAreaMismatch               = 34
} HV_SAVE_RESTORE_STATE_RESULT, *PHV_SAVE_RESTORE_STATE_RESULT;

Constants

HvStateComplete

For HvSavePartitionState, the hypervisor returns the complete state of the partition, and no more state data is available from the hypervisor.

For HvRestorePartitionState, the hypervisor restores the complete state of the partition, and no more state data is expected by the hypervisor.

HvStateIncomplete

The hypervisor did not complete the partition save or restore process and requires additional calls to HvSavePartitionState or HvRestorePartitionState. At this point in the save or restore process, the hypervisor did not detect any error condition.

HvStateRestorable

The partition's potential complete saved state is specifically compatible with respect to the underlying target hardware and hypervisor implementation.

HvStateCorruptData

The partition state is corrupt. For use with HvRestorePartitionState only.

HvStateUnsupportedVersion

The hypervisor implementation is not compatible with the version of the saved state. For use with HvRestorePartitionState only.

HvStateProcessorFeatureMismatch

The features that are supported by the logical processors are incompatible with the features of the logical processors that were in use when the state was saved. For use with HvRestorePartitionState only.

HvStateHardwareFeatureMismatch

The features that are supported by the physical hardware are incompatible with the features of the physical hardware that were in use when the state was saved. For use with HvRestorePartitionState only.

HvStateProcessorCountMismatch

The number of virtual processors that are associated with the restore partition is different from the number of virtual processors that were present when the partition's state was saved. For use with HvRestorePartitionState only.

HvStateProcessorFlagsMismatch

The option flags that are associated with a virtual processor in the restore partition mismatches those option flags that were associated with the equivalent virtual processor when the state was saved. For use with HvRestorePartitionState only.

HvStateProcessorIndexMismatch

The indexes of the virtual processors in the restore partition differ from those indexes that were associated with the virtual processors when the state was saved. For use with HvRestorePartitionState only.

HvStateProcessorInsufficientMemory

HvStateIncompatibleProcessor

HvStateProcessorFeatureSse3Mismatch

HvStateProcessorFeatureLahfSahfMismatch

HvStateProcessorFeaturSsse3eMismatch

HvStateProcessorFeatureSse41Mismatch

HvStateProcessorFeatureSse42Mismatch

HvStateProcessorFeatureSse4aMismatch

HvStateProcessorFeatureSse5Mismatch

HvStateProcessorFeaturePopcntMismatch

HvStateProcessorFeatureCmpxchg16bMismatch

HvStateProcessorFeatureAltmovcr8Mismatch

HvStateProcessorFeatureLzcntMismatch

HvStateProcessorFeatureMisalignedSseMismatch

HvStateProcessorFeatureMmxExtMismatch

HvStateProcessorFeature3DNowMismatch

HvStateProcessorFeatureExtended3DNowMismatch

HvStateProcessorFeaturePage1GBMismatch

HvStateProcessorCacheLineFlushSizeMismatch

HvStateProcessorFeatureXsaveMismatch

HvStateProcessorFeatureXsaveoptMismatch

HvStateProcessorFeatureXsaveLegacySseMismatch

HvStateProcessorFeatureXsaveAvxMismatch

HvStateProcessorFeatureXsaveUnknownFeatureMismatch

HvStateProcessorXsaveSaveAreaMismatch

Remarks

Save and restore status is used with the HvSavePartitionState and HvRestorePartitionState hypercalls.

A client calls HvSavePartitionState or HvRestorePartitionState several times in succession until the hypervisor either returns (that is, saves) or restores the complete state of a partition. A separate status that represents the overall state of the save or restore operation is returned with each of the calls. The status provides feedback that concerns the save or restore process and indicates completion, interim success (incomplete), or an error. The errors indicate that continuation is not possible and why.

Requirements

See also

HvRestorePartitionState

HvSavePartitionState

Send comments about this topic to Microsoft

Build date: 11/16/2013