os/boardsupport/emulator/emulatorbsp/win_drive/win_drive.ini
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
     1 ;==========================================================================
     2 ;   This is the configuration file for the "win_drive.fxt" filesystem extension for the emulator.
     3 ;   See \emulator\wins\win_drive.
     4 ;
     5 ;   This file shall reside in \epoc32\data\ directory.
     6 ;
     7 ;==========================================================================
     8 
     9 [Drive_T]
    10 
    11 
    12 [Drive_X]
    13 ;--------------------------------------------------------------------------
    14 ; The name of the Windows device that can be used by win_drive.fxt extension as the media.
    15 ; The device can be "physical", for example HDD partition or removable drive or "image file", when 
    16 ; the specifie file will be used as EPOC drive.
    17 
    18 ; 1. "Physical" media:
    19 ;   This key value shall look like: DeviceName=\\.\F:
    20 ;   'F:' in this case is the Windows drive letter that will be used. This drive can be removable or 
    21 ;   non-removable. 
    22 ;   preferable settings:
    23 ;     * BytesPerSector=0 or not defined, it is unlikely that Windows drives will use something different
    24 ;                        from 512 bytes; '0' means "use windows volume partition information"
    25 ;
    26 ;     * MediaSizeInSectors=0 or not defined if you wish to use existing partition information for this windows volume.
    27 ;       Or it can be the number of sectors, less than the real number of sectors on this windows drive; in this
    28 ;       case only a part of the drive will be used. It can't be more than maximal number of sectors on the 
    29 ;       specified windows drive - it's impossible to increase the partition size.
    30 ;
    31 ; 2."Image file" media
    32 ;   This key value shall look like: DeviceName=\epoc32\data\media\my_image_file.bin
    33 ;   preferable settings:
    34 ;     * BytesPerSector=0 or not defined for 512 bps; 1024, 2048 and 4096 bps are also valid, 
    35 ;       but if they are supported or not, depends on the appropriate .fsy for this epoc drive.
    36 ;
    37 ;     * MediaSizeInSectors=0 or not defined only for the case, when the image file already exists.
    38 ;       In this case EPOC drive geometry will be calculated depending on the image file size and BytesPerSector value
    39 ;       If 'MediaSizeInSectors' value is specified, the image file will be created/expanded/shunk to correspond
    40 ;       to this size; its size in bytes will be MediaSizeInSectors*BytesPerSector
    41 ;
    42 ; Default value: there is no devault value, the device name must be correctly specified
    43 
    44 ;DeviceName=\\.\F:
    45 ;DeviceName=\\.\Z:
    46 DeviceName=\epoc32\data\media\MMCCRD0A1.BIN
    47 
    48 ;--------------------------------------------------------------------------
    49 ; bytes per sector. Valid values are: 0, 512, 1024, 2048, 4096.
    50 ; '0' means 'Auto' if the media is a physical volume, its partition info will be used in this case,
    51 ;   if the media is the image file, 512 bytes per sector will be used.
    52 ; Actually, using anything rather than 512 is not recommended.
    53 ;
    54 ; Default value:0
    55 
    56 ;BytesPerSector=0
    57 
    58 ;--------------------------------------------------------------------------
    59 ; This parameter specifies the EPOC media size in sectors. 
    60 ;* Value '0' means "Auto". 
    61 ;   In this case if the 'DeviceName' parameter specifies the windows physical volume,
    62 ;   its partition information will be used. If the 'DeviceName' parameter specifies the image file, this file
    63 ;   must exist and its total length will be used to calculate media size in sectors.
    64 ;
    65 ;* If the value of this key is > 0
    66 ;    For physical media it can't be more than maximal number of the sectors on the windows volume;
    67 ;    if less, only the beginning of the partition will be used.
    68 ;    If "image file" media is used, this image file will be opened/created and its size set to MediaSizeInSectors*BytesPerSector
    69 ;
    70 ; Default value:0
    71 
    72 MediaSizeInSectors=40960
    73 
    74 
    75 ;--------------------------------------------------------------------------
    76 ; If this parameter !=0, this EPOC drive ([Drive_*]) will be visible as Read-Only  
    77 ;
    78 ; Default value:0
    79 ;
    80 ;ReadOnly = 1;
    81 
    82 ;--------------------------------------------------------------------------
    83 ; You can override media type (TMediaType) for this particular drive.
    84 ;
    85 ; Default value:0, which means that it won't be overriden by this extension and taken from the original media driver.
    86 ;
    87 ;MediaTypeOverride=3 ;EMediaHardDisk
    88 
    89 ;--------------------------------------------------------------------------
    90 ; You can override media attributes (TLocalDriveCaps::iMediaAtt) for this particular drive by specify 'AND' and 'OR'. 
    91 ; masks that can be applied to the TLocalDriveCaps::iMediaAtt field returned by the original media driver.  
    92 ; These values mut be in hex!
    93 ;
    94 ; Default value for "AND" mask :0xFFFFFFFF
    95 ; Default value for "OR"  mask :0x0
    96 ;MediaAttOverride_AND=0xFFFFFFFD ; will clear KMediaAttFormattable flag
    97 ;MediaAttOverride_OR=0x010 ; will set KMediaAttLockable flag 
    98 
    99 
   100 
   101 ;--------------------------------------------------------------------------
   102 ; You can override drive attributes (TLocalDriveCaps::iDriveAtt) for this particular drive by specify 'AND' and 'OR'. 
   103 ; masks that can be applied to the TLocalDriveCaps::iDriveAtt field returned by the original media driver.  
   104 ; These values mut be in hex!
   105 ;
   106 ; Default value for "AND" mask :0xFFFFFFFF
   107 ; Default value for "OR"  mask :0x0
   108 ;DriveAttOverride_AND=
   109 ;DriveAttOverride_OR=
   110 
   111 
   112 
   113 
   114