3.1.4.16 Application Requests Converting a Virtual Disk to VHD Set

The application provides:

  • A handle to the Open identifying a shared virtual disk.

  • TransactionId: A GUID used to uniquely identify the start operation.

  • DestinationVhdSetName: A name for the VHD set.

The client MUST construct an SVHDX_META_OPERATION_START_REQUEST structure, as specified in section 2.2.4.17, as follows:

The SVHDX_TUNNEL_OPERATION_HEADER MUST be initialized as follows:

  • The OperationCode MUST be set to RSVD_TUNNEL_META_OPERATION_START.

  • The Status field MUST be set to zero.

  • The RequestId field MUST be set to RequestIdentifier.

The SVHDX_META_OPERATION_START_REQUEST MUST be initialized as follows:

  • The TransactionId field is set to the application-provided TransactionId.

  • The OperationType field is set to SvhdxMetaOperationTypeConvertToVHDSet.

  • The Data field to a SVHDX_META_OPERATION_CONVERT_TO_VHDSET structure is initialized as follows:

    • The DestinationVhdSetNameLength field is set to the size, in bytes, of DestinationVhdSetName.

    • The DestinationVhdSetName field is set to the DestinationVhdSetName provided by the application.

The client MUST call the interface specified in [MS-SMB2] section 3.2.4.20.11, supplying the following input parameters:

  • Application-provided handle to identify the Open.

  • Control code: FSCTL_SVHDX_ASYNC_TUNNEL_REQUEST.

  • SVHDX_META_OPERATION_START_REQUEST structure as payload.