Media Table
The Media table describes the set of disks that make up the source media for the installation.
The Media table contains the columns shown in the following table.
Column | Type | Key | Nullable |
---|---|---|---|
DiskId | Integer | Y | N |
LastSequence | Integer | N | N |
DiskPrompt | Text | N | Y |
Cabinet | Cabinet | N | Y |
VolumeLabel | Text | N | Y |
Source | Property | N | Y |
-
DiskId
-
Determines the sort order for the table. This number must be equal to or greater than 1.
-
LastSequence
-
File sequence number for the last file for this media. The numbers in the LastSequence column specify which of the files in the File table are found on a particular source disk. Each source disk contains all files with sequence numbers (as shown in the Sequence column of the File table) less than or equal to the value in the LastSequence column, and greater than the LastSequence value of the previous disk (or greater than 0, for the first entry in the Media table). This number must be non-negative; the maximum limit is 32767 files. For more information about creating a Windows Installer package with more files, see Authoring a Large Package.
-
DiskPrompt
-
The disk name, which is usually the visible text printed on the disk. This localizable text is used to prompt the user when this disk needs to be inserted.
-
Cabinet
-
The name of the cabinet if some or all of the files stored on the media are compressed into a cabinet file. If no cabinets are used, this column must be blank. The name of the cabinet must use the syntax of the Cabinet data type. Windows Installer always requires a valid source to repair files included in embedded cabinet files. When Windows Installer installs a package containing an embedded cabinet file, a copy of the cabinet file can be saved by the system. This copy cannot be used to repair the cabinet file. To conserve disk space, use external cabinet files instead of embedded cabinet files.
-
VolumeLabel
-
The label attributed to the volume. This is the volume label returned by the GetVolumeInformation function. If the SourceDir property refers to a removable (floppy or CD-ROM) volume, then this volume label is used to verify that the proper disk is in the drive before attempting to install files. The entry in this column must match the volume label of the physical media.
-
Source
-
This field is only used by patching and is otherwise left blank. A patch transform can enter a property here that is the location of the cabinet file containing the patch files or any new files added by the patch. A different source needs to be specified for these files because the source of the patch package can be stored separately from the product's source. If the Cabinet field is empty, the installer ignores the value in this column. If this field is empty, the installer uses the value of the SourceDir property as the source of the cabinet.
If the cabinet name is preceded by a number sign (#), then the files referencing this Media table record are packed in a cabinet file that is stored within the database as a separate stream.
For more information about how to add cabinets to the File tables and Media tables, see Using Cabinets and Compressed Sources.
Windows Installer requires that the .msi file be on the first disk of removable media (CD, DVD or floppy) used for the product's installation.
Determining the SourceMode
The Word Count Summary property determines the source mode for the current install. If this property is set to 2 or 3, a cabinet install is assumed. In this mode, the cabinet files are assumed to exist in the directory indicated by the SourceDir property. If the Source Type value is 0 or 1, all source files are assumed to exist in the tree whose root is indicated by the SourceDir property.
Note that this only applies to files in the File table that do not have either the Compressed or Uncompressed bits set in the attributes column. These bits override the value of the Word Count Summary property when determining if a particular file is compressed or uncompressed.