Virtual Disk API Programming Guide - Documentation - VMware

5Vi
Virtual Disk API Sample Code 5
This chapter discusses the VDDK sample program, in the following sections:
“Compiling the Sample Program” on page 43
“Usage Message” on page 44
“Walk‐Through of Sample Program” on page 45
Compiling the Sample Program
The sample program is written in C++, although the Virtual Disk API also supports C.
For compilation to succeed, the correct DLLs or shared objects must be loaded. You can ensure the success of
dynamic loading in a variety of ways.
Set the path inside the VDDK program.
Set the path for the shell being used in Linux or in Visual Studio for Windows.
For a default installation, the Linux path is /usr/share/doc/vmware-vix-disklib/sample.
In Windows, set the Path element in the System Variables.
To do this in Windows XP, right‐click Computer > Properties > Advanced > Environment Variables,
select Path in the System Variables lower list, click Edit, and add the path of the VDDK bin directory.
In Windows 7, right‐click Computer > Properties > Advanced System Settings > Environment Variables,
select Path in the System Variables list, click Edit, and add the path of the VDDK bin directory.
C:\Program Files\VMware\VMware Virtual Disk Development Kit\doc\sample\ is the default path.
Note that VDDK loads DLLs by relative path rather than absolute path, so conflicting versions of the DLLs
could cause problems.
Visual C++ on Windows
To compile the program, find the sample source vixDiskLibSample.cpp at this location:
C:\Program Files\VMware\VMware Virtual Disk Development Kit\doc\sample\
Double‐click the vcproj file, possibly convert format to a newer version, and choose Build > Build Solution.
To execute the compiled program, choose Debug > Start Without Debugging, or type this in a command
prompt after changing to the doc\sample location given above:
Debug\vixdisklibsample.exe
SLN and VCPROJ Files
The Visual Studio solution file vixDiskLibSample.sln and project file vixDiskLibSample.vcproj are
included in the sample directory.
VMware, Inc. 43