MERGE_VIRTUAL_DISK_PARAMETERS structure (virtdisk.h)

Contains virtual hard disk (VHD) merge request parameters.

Syntax

typedef struct _MERGE_VIRTUAL_DISK_PARAMETERS {
  MERGE_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      ULONG MergeDepth;
    } Version1;
    struct {
      ULONG MergeSourceDepth;
      ULONG MergeTargetDepth;
    } Version2;
  };
} MERGE_VIRTUAL_DISK_PARAMETERS, *PMERGE_VIRTUAL_DISK_PARAMETERS;

Members

Version

A MERGE_VIRTUAL_DISK_VERSION enumeration that specifies the version of the MERGE_VIRTUAL_DISK_PARAMETERS structure being passed to or from the VHD functions.

Version1

This structure is used when the Version member is MERGE_VIRTUAL_DISK_VERSION_1 (1).

Version1.MergeDepth

Depth of the merge request. This is the number of parent disks in the differencing chain to merge together.

Note  The RWDepth of the virtual disk must be greater than MergeDepth. For more information, see OPEN_VIRTUAL_DISK_PARAMETERS.

 

Version2

This structure is used when the Version member is MERGE_VIRTUAL_DISK_VERSION_2 (2).

Windows 7 and Windows Server 2008 R2:  This value is not supported until Windows 8 and Windows Server 2012.

Version2.MergeSourceDepth

Depth from the leaf from which to begin the merge. The leaf is at depth 1.

Version2.MergeTargetDepth

Depth from the leaf to target the merge. The leaf is at depth 1.

Remarks

The depth of a merge request specified by the MergeDepth member is the number of
parent VHD image files in the differencing chain to be merged. For more information, see MergeVirtualDisk.

Requirements

Requirement	Value
Minimum supported client	Windows 7
Minimum supported server	Windows Server 2008 R2
Header	virtdisk.h

See also

About VHD

MergeVirtualDisk

VHD Reference