2.2.4.17.1 SVHDX_META_OPERATION_CREATE_SNAPSHOT Structure

The SVHDX_META_OPERATION_CREATE_SNAPSHOT structure is used to send the additional parameters for snapshot creation.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

SnapshotType

Flags

Stage1

Stage2

Stage3

Stage4

Stage5

Stage6

SnapshotId

...

...

...

ParametersPayloadSize

CdpParameters (variable)

...

SnapshotType (4 bytes): The type of snapshot. This field MUST contain one of the values defined in section 2.2.6.

Flags (4 bytes): This field MUST be set to zero or a combination of the following values:

Name

Meaning

SVHDX_SNAPSHOT_DISK_FLAG_ENABLE_CHANGE_TRACKING 0x00000001

A request is made for change tracking to be enabled when snapshot is taken.

Stage1 (4 bytes): The first stage. This field MUST contain one of the following values.

Name

Meaning

SvhdxSnapshotStageInitialize

0x00000001

Perform any required initialization so that the appropriate type of snapshot can be taken.

SvhdxSnapshotStageBlockIO

0x00000002

Temporarily pause all IO against the target virtual device.

SvhdxSnapshotStageSwitchObjectStore

0x00000003

Switch aspects of the underlying object store so that the appropriate snapshot is taken.

SvhdxSnapshotStageUnblockIO

0x00000004

Allow further IO against the target virtual device.

SvhdxSnapshotStageFinalize

0x00000005

Tear down any state associated with a snapshot of the target virtual device.

Stage2 (4 bytes): The second stage. This field MUST be any of the values identified in Stage1 or in SvhdxSnapshotStageInvalid, defined as follows.

Name

Meaning

SvhdxSnapshotStageInvalid

0x00000000

No stage present in this field.

Stage3 (4 bytes): The third stage. This field MUST be any of the values identified in Stage1 or SvhdxSnapshotStageInvalid.

Stage4 (4 bytes) The fourth stage. This field MUST be any of the values identified in Stage1 or SvhdxSnapshotStageInvalid.

Stage5 (4 bytes): The fifth stage. This field MUST be any of the values identified in Stage1 or SvhdxSnapshotStageInvalid.

Stage6 (4 bytes): The sixth stage. This field MUST be any of the values identified in Stage1 or SvhdxSnapshotStageInvalid.

SnapshotId (16 bytes): The ID to assign to the snapshot.

ParametersPayloadSize (4 bytes): The size of any parameters included with the create snapshot request. This field MUST be set to 0.

CdpParameters (variable): Parameters supplied with the continuous data protection snapshot (CDP snapshot) operation. This field is provided in the format SVHDX_META_OPERATION_CREATE_CDP_PARAMETER as specified in section 2.2.4.17.1.1.