MERGE_VIRTUAL_DISK_PARAMETERS structure

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).

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.
MergeSourceDepth

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

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

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

Header

VirtDisk.h (include Windows.h)

See also

About VHD
MergeVirtualDisk
VHD Reference

 

 

Build date: 10/26/2012

Community Additions

ADD
Show:
© 2014 Microsoft