Skip to content

Latest commit

 

History

History
201 lines (162 loc) · 5.48 KB

ns-virtdisk-open_virtual_disk_parameters.md

File metadata and controls

201 lines (162 loc) · 5.48 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:virtdisk._OPEN_VIRTUAL_DISK_PARAMETERS
OPEN_VIRTUAL_DISK_PARAMETERS (virtdisk.h)
Contains virtual disk open request parameters.
*POPEN_VIRTUAL_DISK_PARAMETERS
OPEN_VIRTUAL_DISK_PARAMETERS
OPEN_VIRTUAL_DISK_PARAMETERS structure [VHD]
OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT
OPEN_VIRTUAL_DISK_VERSION_1
OPEN_VIRTUAL_DISK_VERSION_2
POPEN_VIRTUAL_DISK_PARAMETERS
POPEN_VIRTUAL_DISK_PARAMETERS structure pointer [VHD]
_OPEN_VIRTUAL_DISK_PARAMETERS
vdssys/OPEN_VIRTUAL_DISK_PARAMETERS
vdssys/POPEN_VIRTUAL_DISK_PARAMETERS
vhd.open_virtual_disk_parameters
virtdisk/OPEN_VIRTUAL_DISK_PARAMETERS
virtdisk/POPEN_VIRTUAL_DISK_PARAMETERS
vhd\open_virtual_disk_parameters.htm
VStor
ad67bc3e-a0fe-4198-9307-819577abef7f
08/19/2020
*POPEN_VIRTUAL_DISK_PARAMETERS, OPEN_VIRTUAL_DISK_PARAMETERS, OPEN_VIRTUAL_DISK_PARAMETERS structure [VHD], OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT, OPEN_VIRTUAL_DISK_VERSION_1, OPEN_VIRTUAL_DISK_VERSION_2, POPEN_VIRTUAL_DISK_PARAMETERS, POPEN_VIRTUAL_DISK_PARAMETERS structure pointer [VHD], _OPEN_VIRTUAL_DISK_PARAMETERS, vdssys/OPEN_VIRTUAL_DISK_PARAMETERS, vdssys/POPEN_VIRTUAL_DISK_PARAMETERS, vhd.open_virtual_disk_parameters, virtdisk/OPEN_VIRTUAL_DISK_PARAMETERS, virtdisk/POPEN_VIRTUAL_DISK_PARAMETERS
virtdisk.h
Windows
Windows 7
Windows Server 2008 R2
Windows
OPEN_VIRTUAL_DISK_PARAMETERS, *POPEN_VIRTUAL_DISK_PARAMETERS
19H1
_OPEN_VIRTUAL_DISK_PARAMETERS
virtdisk/_OPEN_VIRTUAL_DISK_PARAMETERS
POPEN_VIRTUAL_DISK_PARAMETERS
virtdisk/POPEN_VIRTUAL_DISK_PARAMETERS
OPEN_VIRTUAL_DISK_PARAMETERS
virtdisk/OPEN_VIRTUAL_DISK_PARAMETERS
c++
APIRef
kbSyntax
HeaderDef
VirtDisk.h
vdssys.h
OPEN_VIRTUAL_DISK_PARAMETERS

OPEN_VIRTUAL_DISK_PARAMETERS structure

-description

Contains virtual disk open request parameters.

-struct-fields

-field Version

An OPEN_VIRTUAL_DISK_VERSION enumeration that specifies the version of the OPEN_VIRTUAL_DISK_PARAMETERS structure being passed to or from the VHD functions.

Value Meaning
OPEN_VIRTUAL_DISK_VERSION_1
1
Use the Version1 member of this structure.
OPEN_VIRTUAL_DISK_VERSION_2
2
Use the Version2 member of this structure.

-field Version1

This structure is used if the Version member is OPEN_VIRTUAL_DISK_VERSION_1 (1).

-field Version1.RWDepth

Indicates the number of stores, beginning with the child, of the backing store chain to open as read/write. The remaining stores in the differencing chain will be opened read-only. This is necessary for merge operations to succeed.

Value Meaning
0
Do not open for read/write at any depth. This value should be used for read-only operations.
OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT
1
Default value to use if no other value is desired.
n (user-defined)
This integer value should be the number of merge levels plus one, if a merge operation is intended.

-field Version2

This structure is used if the Version member is OPEN_VIRTUAL_DISK_VERSION_2 (2).

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

-field Version2.GetInfoOnly

If TRUE, indicates the handle is only to be used to get information on the virtual disk.

-field Version2.ReadOnly

If TRUE, indicates the file backing store is to be opened as read-only.

-field Version2.ResiliencyGuid

Resiliency GUID to specify when opening files.

Note

The following parameters prefaced Version3 are intended for internal use.

-syntax

typedef struct _OPEN_VIRTUAL_DISK_PARAMETERS {
  OPEN_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      ULONG RWDepth;
    } Version1;
    struct {
      BOOL GetInfoOnly;
      BOOL ReadOnly;
      GUID ResiliencyGuid;
    } Version2;
  };
} OPEN_VIRTUAL_DISK_PARAMETERS, *POPEN_VIRTUAL_DISK_PARAMETERS;

-see-also

About VHD

OpenVirtualDisk

VHD Reference