The HV_EXPLICIT_SUSPEND_REGISTER union identifies how the HvRegisterExplicitSuspend register is encoded.

typedef union _HV_EXPLICIT_SUSPEND_REGISTER {
  UINT64  AsUINT64;
  struct {
      UINT64  Suspended:1;
      UINT64  Reserved:63;
  };
} HV_EXPLICIT_SUSPEND_REGISTER, *PHV_EXPLICIT_SUSPEND_REGISTER;

Members

AsUINT64

A member in the union that can hold one 64-bit value that identifies whether to explicitly suspend or unsuspend the virtual processor.

Suspended

A UINT64 value that specifies whether to explicitly suspend or unsuspend the virtual processor. Setting this member is equivalent to setting the first bit of the 64-bit AsUINT64 member (0x0000000000000001).

Reserved

This member is reserved and should be set to zero. Setting this member to zero is equivalent to setting the remaining 63 bits (0xFFFFFFFFFFFFFFFE) of the 64-bit AsUINT64 member to zeros.

Comments

A caller can use the HV_EXPLICIT_SUSPEND_REGISTER union in a call to the HvSetVpRegisters hypercall to explicitly suspend or unsuspend the virtual processor. The HvRegisterExplicitSuspend register is not defined by the underlying processor architecture and cannot be accessed by the virtual processor that the register is associated with.

The HvRegisterExplicitSuspend register is used for cases where the virtual processor is to be explicitly suspended using the HvSetVpRegisters hypercall.

Requirements

Headers: Defined in HvValApi.h. Include Hvgdk.h.

See Also

HvSetVpRegisters