2.2.4.12 SVHDX_OPEN_DEVICE_CONTEXT Structure

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

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

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

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.