| WiX Database XML Schema |
Element: Media
Description
Media element describes a disk that makes up the source media for the installation.
Derived By
Restricting anyType
Attributes
| Name | Type | Required? | Default | Description |
|---|---|---|---|---|
| Id | integer | Yes | Disk identifier for Media table. |
|
| Cabinet | string | No | The name of the cabinet if some or all of the files stored on the media are in a cabinet file. |
|
| CompressionLevel | NMTOKEN (restriction) | No | Indicates the compression level for the Media's cabinet. |
|
| DiskPrompt | string | No | The disk name, which is usually the visible text printed on the disk. |
|
| EmbedCab | YesNoType | No | Instructs the binder to embed the cabinet in the product if 'yes'. |
|
| Layout | string | No | This attribute specifies the root directory for the uncompressed files that are a part of this Media element. |
|
| src | string | No | ||
| VolumeLabel | string | No | The label attributed to the volume. |
|
| Source | string | No | Optional property that identifies the source of the embedded cabinet. |
Content Model
Contains elements as defined in the following table.
| Component | Type | Occurs | Description |
|---|---|---|---|
 |
1..1 | ||
 |
0..* | ||
| DigitalSignature | anyType (restriction) | 0..1 | Adds a digital signature. |
| PatchBaseline | anyType (restriction) | 0..* | Identifies a set of product versions. |
| SymbolPath | anyType (restriction) | 1..1 | A path to symbols. |
Referenced By
- Element Fragment
Definition
<xs:element name="Media">
<xs:annotation>
<xs:documentation>Media element describes a disk that makes up the source media for the installation.</xs:documentation>
<xs:appinfo>
<xse:msiRef table="Media" href="http://msdn.microsoft.com/library/aa369801.aspx" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
</xs:appinfo>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element ref="DigitalSignature" minOccurs="0" />
<xs:element ref="PatchBaseline" minOccurs="0" maxOccurs="unbounded" />
<xs:element ref="SymbolPath" />
</xs:choice>
</xs:sequence>
<xs:attribute name="Id" type="xs:integer" use="required">
<xs:annotation>
<xs:documentation>Disk identifier for Media table. This number must be equal to or greater than 1.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Cabinet" type="xs:string">
<xs:annotation>
<xs:documentation>The name of the cabinet if some or all of the files stored on the media are in a cabinet file. If no cabinets are used, this attribute must not be set.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="CompressionLevel">
<xs:annotation>
<xs:documentation>
Indicates the compression level for the Media's cabinet. This attribute can
only be used in conjunction with the Cabinet attribute. The default is 'mszip'.
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:NMTOKEN">
<xs:enumeration value="high" />
<xs:enumeration value="low" />
<xs:enumeration value="medium" />
<xs:enumeration value="mszip" />
<xs:enumeration value="none" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="DiskPrompt" type="xs:string">
<xs:annotation>
<xs:documentation>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. This value will be used in the "[1]" of the DiskPrompt Property. Using this attribute will require you to define a DiskPrompt Property.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="EmbedCab" type="YesNoType">
<xs:annotation>
<xs:documentation>Instructs the binder to embed the cabinet in the product if 'yes'. This attribute can only be specified in conjunction with the Cabinet attribute.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Layout" type="xs:string">
<xs:annotation>
<xs:documentation>
This attribute specifies the root directory for the uncompressed files that
are a part of this Media element. By default, the src will be the output
directory for the final image. The default value ensures the binder generates
an installable image. If a relative path is specified in the src attribute,
the value will be appended to the image's output directory. If an absolute
path is provided, that path will be used without modification. The latter two
options are provided to ease the layout of an image onto multiple medias (CDs/DVDs).
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="src" type="xs:string">
<xs:annotation>
<xs:appinfo>
<xse:deprecated ref="Layout" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
</xs:appinfo>
</xs:annotation>
</xs:attribute>
<xs:attribute name="VolumeLabel" type="xs:string">
<xs:annotation>
<xs:documentation>
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.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Source" type="xs:string">
<xs:annotation>
<xs:documentation>
Optional property that identifies the source of the embedded cabinet.
If a cabinet is specified for a patch, this property should be defined
and unique to each patch so that the embedded cabinet containing patched
and new files can be located in the patch package. If the cabinet is not
embedded - this is not typical - the cabinet can be found in the directory
referenced in this column. If empty, the external cabinet must be located
in the SourceDir directory.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>