2.2.4.32 SVHDX_OPEN_DEVICE_CONTEXT_V2 Structure

The SVHDX_OPEN_DEVICE_CONTEXT_V2 packet is sent by the client to open the shared virtual disk.

This is valid only for the RSVD Protocol version 2.


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

Version

HasInitiatorId

Reserved

InitiatorId

...

...

...

Flags

OriginatorFlags

OpenRequestId

...

InitiatorHostNameLength

InitiatorHostName (126 bytes)

...

...

VirtualDiskPropertiesInitialized

ServerServiceVersion

VirtualSectorSize

PhysicalSectorSize

VirtualSize

...

Version (4 bytes): The version of the create context. It MUST be set to RSVD_ECP_CONTEXT_VERSION_2.

HasInitiatorId (1 byte): A Boolean value that, if set to TRUE (0x01), indicates that the message has a valid InitiatorId.

Reserved (3 bytes): This field MUST be set to zero when sent and MUST be ignored on receipt.

InitiatorId (16 bytes): A GUID that optionally identifies the initiator of the open request.

Flags (4 bytes): An application-provided value for the open.

OriginatorFlags (4 bytes): This field is used to indicate which component has originated or issued the operation. This field MUST be set to one of the following values:

Name

Meaning

SVHDX_ORIGINATOR_PVHDPARSER

0x00000001

Shared virtual disk file to be opened as a virtual SCSI disk device

SVHDX_ORIGINATOR_VHDMP

0x00000004

Shared virtual disk file to be opened in underlying object store

OpenRequestId (8 bytes): A 64-bit value assigned by the client for an outgoing request.

InitiatorHostNameLength (2 bytes): The length, in bytes, of the InitiatorHostName. This value MUST be less than or equal to RSVD_MAXIMUM_NAME_LENGTH.

InitiatorHostName (126 bytes): A 126-byte buffer containing a Unicode UTF-16 string that specifies the computer name on which the initiator resides.

VirtualDiskPropertiesInitialized (4 bytes): This field MUST be set to zero.

ServerServiceVersion (4 bytes): This field MUST be set to zero.

VirtualSectorSize (4 bytes): This field MUST be set to zero.

PhysicalSectorSize (4 bytes): This field MUST be set to zero.

VirtualSize (8 bytes): This field MUST be set to zero.