HvInitializePartition function

The HvInitializePartition function is called by a parent partition to initialize a child partition.

Syntax


HV_STATUS  HvInitializePartition(
  _In_  HV_PARTITION_ID PartitionId
);

Parameters

PartitionId [in]: An HV_PARTITION_ID value that identifies the child partition to initialize. HV_PARTITION_ID is defined as an unsigned 64-bit (UINT64) value.

Return value

HvInitializePartition returns one of the following values. In addition to these values, HvInitializePartition can also return one of the values that are specified in Common Hypercall Status Codes.

Return code	Description
HV_STATUS_SUCCESS	HvInitializePartition successfully initialized the child partition.
HV_STATUS_ACCESS_DENIED	The specified partition is not a child of the caller.
HV_STATUS_INVALID_PARTITION_ID	The specified partition identifier is invalid.
HV_STATUS_INVALID_PARTITION_STATE	The specified partition is not in the uninitialized state.
HV_STATUS_INSUFFICIENT_MEMORY	The number of pages in the memory pool of the specified partition is insufficient to perform the operation.
HV_STATUS_NO_RESOURCES	A required system resource is unavailable or an implementation limit has been reached.

Remarks

The HvInitializePartition call is used to bring a partition from the uninitialized to the active state. The child partition must be in the uninitialized state; that is, it must have been allocated with a call to HvCreatePartition. Prior to using the HvInitializePartition hypercall, the caller might be required to initially populate the partition's memory pool. For information on memory pools, see Memory Pools. The internal data structures allocated by this hypercall are allocated preferentially from the proximity domain specified by the caller in the related HvCreatePartition hypercall.

HvInitializePartition has the following restriction:

The partition that the PartitionId parameter specifies must be in the uninitialized state.

Native Interface

HvInitializePartition [fast]
	Call Code = 0x0041
Input Parameters
0	PartitionId (8 bytes)

Requirements

Version	HvInitializePartition is available in version 1.0 and later versions of the hypervisor.
Header	Hvgdk.h (include Hvgdk.h)
IRQL	Any level

Send comments about this topic to Microsoft

Build date: 11/16/2013