include dosmgr.inc VxDcall _DOSMGR_Set_Exec_VM_Data, <VM, CommTail, PRGName, InitDrvDir> |
The _DOSMGR_Set_Exec_VM_Data service sets the data for the initial execution into a virtual machine. It is reserved for exclusive use by the virtual shell device.
This service can be called during the Create_VM message because it does not simulate calls or interrupts into the virtual machine; it just sets instance data.
VM
Specifies the handle of the virtual machine to set execution data for.
CommTail
Points to the command tail for the execution. The tail can be up to 128 bytes. The first byte must specify the number of bytes in the tail; the last byte must be 0Dh.
PRGName
Points to null-terminated string specifying the name of the program to execute.
InitDrvDir
Points to a null-terminated string specifying the initial directory and drive for the virtual machine. The drive letter must be a capital letter. The string must be less than or equal to 64 characters, including null terminator.
If this parameter is zero, the service does not set the default directory. This form of the service is made by the DOSMGR_Exec_VM service. Other virtual devices should not use this form.
This service has no return value.
This service must be called before calling the _DOSMGR_Exec_VM service.