vdrive(PCI)                    6 January 1993                    vdrive(PCI)


 Name

    vdrive - return the drive number of a virtual drive

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int vdrive( vdrvnum )
    int vdrvnum;


 Description

    vdrive is a function that returns the DOS drive number of a virtual
    drive.

    vdrive(0) returns the total number of virtual drives.

    vdrive(vdrvnum) returns the DOS drive number of virtual drive vdrvnum.
    vdrvnum must be a value between 1 and vdrive(0).

 Return value

    The drive numbers returned by vdrive(n) are 1 for drive A:, 2 for drive
    B:, and so on.  These drives may or may not be currently logged in.

    If no virtual drives are associated with the personal computer or the
    vdrvnum argument is greater than vdrive(0), a value of 0 returns.

 Example


               :
               :
       int driveNum;
       int drive;
       int i;
               :
               :
       /* First get the number of virtual drives.*/
       if ( (driveNum = vdrive(0)) == 0 ) {
               /* no virtual drives */
               errorHandler();
       } else {
               printf("Number of virtual drives: %d \n", driveNum);
               /* Get DOS drive letter for each virtual drive.*/
               for (i = 1; i <= driveNum; i++) {
                  drive = vdrive(i);
                  printf("Virtual drive %d = DOS drive %c:\n",i,
                       drive+'A'-1);
       }
               :
               :


 See also

    isvirtual(PCI), vhost(PCI)