通过

Autorun.inf 条目

  • 项目

本主题是可在 Autorun.inf 文件中使用的条目的参考。 条目由一个键和一个值组成。

[AutoRun]钥匙

action

操作项指定在自动播放对话框中用于表示在媒体的 Autorun.inf 文件中打开或 shellexecute 项中指定的程序的处理程序的文本。 该值可以表示为文本或二进制文件中存储的资源。

action=ActionText

action=@[filepath\]filename,-resourceID

parameters

  • ActionText

    自动播放对话框中用于表示在媒体的 Autorun.inf 文件中 打开 或 shellexecute 条目中指定的程序的处理程序的文本。

  • filepath

    一个字符串，其中包含包含字符串的二进制文件的目录的完全限定路径。 如果未指定路径，则文件必须位于驱动器的根目录中。

  • filename

    包含二进制文件名称的字符串。

  • resourceID

    二进制文件中字符串的 ID。

备注

操作密钥仅在 Windows XP Service Pack 2 (SP2) 或更高版本中使用。 它仅支持类型为 DRIVE_REMOVABLE 和 DRIVE_FIXED 的驱动器。 对于DRIVE_REMOVABLE，需要 操作 密钥。 将忽略音频 CD 或电影 DVD 的 Autorun.inf 文件中 的操作 命令，并且这些媒体在 Windows XP Service Pack 1 (SP1) 及更早版本中继续运行。

自动播放对话框中显示的字符串是通过将 操作 条目中指定的文本与命名提供程序的硬编码文本（由 Shell 提供的）组合在一起构造的。 图标显示在它旁边。 此项始终显示为“自动播放”对话框中的第一个选项，默认情况下处于选中状态。 如果用户接受 选项，则会启动由媒体 Autorun.inf 文件中 的 open 或 shellexecute 条目指定的应用程序。 在这种情况下， “始终执行所选操作” 选项不可用。

操作和图标键共同定义最终用户在“自动播放”对话框中看到的应用程序的表示形式。 它们应以用户可以轻松识别的方式进行组合。 它们应指示要运行的应用程序、创建该应用程序的公司以及任何关联的品牌。

为了向后兼容，对于DRIVE_FIXED类型的设备， 操作 条目是可选的。 对于此类型，如果 Autorun.inf 文件中没有 操作 条目，则自动播放对话框中使用默认条目。

对于DRIVE_REMOVABLE类型的设备，操作条目是必需的，而到目前为止它还没有 Autorun.inf 支持。 如果不存在 任何操作 条目，则显示“自动播放”对话框，但没有启动其他内容的选项。

CustomEvent

CustomEvent 条目指定自定义的自动播放内容事件。

CustomEvent=CustomEventName

parameters

  • CustomEventName

    包含自动播放内容事件的名称的文本字符串。 名称必须不超过 100 个字母数字字符。

备注

可以在卷的 Autorun.inf 文件中包括自定义事件名称。 当自动播放提示用户提供与卷一起使用的应用程序时，它仅显示已注册指定自定义事件名称的应用程序。 有关如何将应用程序注册为自定义自动播放内容事件的处理程序的信息，请参阅 使用自动播放自动启动 或 如何注册事件处理程序。

以下示例将值“MyContentOnArrival”指定为新的自动播放内容事件。

CustomEvent=MyContentOnArrival

icon

图标项指定表示 Windows 用户界面中已启用自动运行的驱动器的图标。

icon=iconfilename[,index]

parameters

  • iconfilename

    包含图标信息的 .ico、.bmp、.exe或.dll文件的名称。 如果文件包含多个图标，则还必须指定图标的从零开始的索引。

备注

图标与标签一起表示 Windows 用户界面中已启用自动运行的驱动器。 例如，在 Windows 资源管理器中，驱动器由此图标而不是标准驱动器图标表示。 图标的文件必须与 open 命令指定的文件位于同一目录中。

以下示例指定 MyProg.exe 文件中的第二个图标。

icon=MyProg.exe,1

label

标签条目指定一个文本标签，该标签表示 Windows 用户界面中已启用自动运行的驱动器。

label=LabelText

parameters

  • LabelText

    包含标签的文本字符串。 它可以包含空格，长度不应超过 32 个字符。

注意

可以在 LabelText 参数中放置超过 32 个字符且未收到错误消息的值。 但是，系统仅显示前 32 个字符。 第 32 个之后的任何字符将被截断且不显示。 例如，如果 LabelText 如下所示：label=“此 CD 设计为最终音乐 CD。”将显示以下内容，“此 CD 设计为 ul”。

 

备注

标签以及图标表示 Windows 用户界面中已启用自动运行的驱动器。

以下示例将值“我的驱动器标签”指定为驱动器的标签。

label=My Drive Label

打开

打开的条目指定当用户在驱动器中插入光盘时自动运行启动的应用程序的路径和文件名。

open=[exepath\]exefile [param1 [param2] ...]

parameters

  • exefile

    插入 CD 时运行的可执行文件的完全限定路径。 如果只指定了文件名，则它必须位于驱动器的根目录中。 若要在子目录中查找文件，必须指定路径。 还可以包含一个或多个要传递给启动应用程序的命令行参数。

UseAutoPlay

在 Windows XP 上， UseAutoPlay 条目指定应使用自动播放而不是自动运行。

在 Windows Vista 及更高版本上，此项会导致使用 打开 项或 shellexecute 条目) 自动运行 (指定的任何操作在“自动播放”对话框中被禁止显示。 此项对早于 Windows XP 的 Windows 版本没有影响。

在 Windows 8 及更高版本中，将值指定为 0 将禁用此设备的自动播放。

parameters

若要使用此选项，请将 UseAutoPlay 的条目添加到 Autorun.inf 文件，并将该条目设置为等于 1。 早于 Windows 8 的 Windows 版本不支持其他值。

在 Windows 8 及更高版本中，指定值 0 以禁用此设备的自动播放。

UseAutoPlay=1

备注

目前， UseAutoPlay 仅适用于 Windows XP 或更高版本，并且仅适用于 GetDriveType 确定为 DRIVE_CDROM 类型的驱动器。

使用 UseAutoPlay 时，Windows XP 上将忽略 Autorun.inf 中的 打开 项或 shellexecute 条目指定的任何操作，并从 Windows Vista 上的“自动播放”对话框中省略。

自动运行通常用于自动运行或加载插入的媒体上包含的内容，而“自动播放”则显示一个对话框，其中包含可能执行的相关操作的列表，并使用户能够选择要执行的操作。 有关自动运行和自动播放之间的差异的详细信息，请参阅 创建启用了自动运行功能的 CD-ROM 应用程序和 分别 使用和配置自动播放。

用法示例

CD 包含三个文件：Autorun.inf、Readme.txt 和 Music.wma。 根据使用的 Windows 版本和 Autorun.inf 中指定的选项，当插入 CD (假定为插入 CD 的驱动器启用了自动运行/自动播放) 的情况下，该 CD 可以由自动运行或自动播放来处理。

首先，请考虑包含以下内容的 Autorun.inf 文件，注意未指定 UseAutoPlay=1 ：

[AutoRun]
shellexecute="Readme.txt"

插入此 CD 时 Shell 执行的操作取决于所使用的 Windows 版本：

  • 在 Windows XP 或更早版本中，插入此 CD 时由 AutoRun 处理。 在这种情况下，将读取 shellexecute 条目，并且 Shell 调用与.txt文件关联的文件处理程序;这通常会在记事本中打开Readme.txt。
  • 在 Windows Vista 上，存在带有 shellexecute 条目的 Autorun.inf 文件会导致媒体被标识为自动播放类型“软件和游戏”。 在这种情况下，用户会看到一个自动播放对话框，其中包括 shellexecute 条目指定的操作， (对话框) 显示为“加载Readme.txt”，以及与类型为“软件和游戏”的媒体关联的默认操作。

若要指示应在 Windows XP 上使用自动播放而不是自动运行，并且应在 Windows Vista 上的“自动播放”对话框中禁止使用 AutoRun shellexecute 项指定的操作，请将 UseAutoPlay 插入 Autorun.inf 文件中，如下所示：

[AutoRun]
shellexecute="Readme.txt"
UseAutoPlay=1

同样，插入此 CD 时 Shell 执行的操作取决于正在使用的 Windows 版本。

  • 在早于 Windows XP 的 Windows 版本中，仍使用 AutoRun 并执行 shellexecute 指定的操作，如前所述。 (请注意，只有 AutoRun 在早于 Windows XP.) 的 Windows 版本上可用
  • 在 Windows XP 上， UseAutoPlay 条目会导致使用自动播放代替自动运行。 在这种情况下，自动播放确定媒体包含 Windows Media Audio (.wma) 文件，并将内容分类为“音乐文件”。 向用户显示一个自动播放对话框，其中包含“音乐文件”自动播放媒体类型的已注册处理程序;将忽略 AutoRun shellexecute 条目。

shellexecute

版本 5.0。 shellexecute 条目指定 AutoRun 将用于调用 ShellExecuteExecuteEx 的应用程序或数据文件。

shellexecute=[filepath\]filename[param1, [param2]...]

parameters

  • filepath

    一个字符串，其中包含包含数据或可执行文件的目录的完全限定路径。 如果未指定路径，则文件必须位于驱动器的根目录中。

  • filename

    包含文件名的字符串。 如果它是可执行文件，则会启动它。 如果它是数据文件，则必须是 文件类型的成员。 ShellExecuteEx 启动与文件类型关联的默认命令。

  • paramx

    包含应传递给 ShellExecuteEx 的任何其他参数。

备注

此条目类似于 打开，但它允许使用 文件关联 信息来运行应用程序。

shell

shell 条目指定驱动器快捷菜单的默认命令。

shell=verb

parameters

  • 谓词

    对应于菜单命令的谓词。 谓词及其关联的菜单命令必须在 Autorun.inf 文件中使用 shell\verb 条目定义。

备注

当用户右键单击驱动器图标时，将显示快捷菜单。 如果存在 Autorun.inf 文件，则从该文件获取默认快捷菜单命令。 当用户双击驱动器的图标时，也会执行此命令。

若要指定默认快捷菜单命令，请先使用 shell\verb 定义其谓词、命令字符串和菜单文本。 然后使用 shell 将其设置为默认快捷菜单命令。 否则，默认菜单项文本将为“自动播放”，这将启动 由打开 项指定的应用程序。

shell\verb

shell\verb 条目将自定义命令添加到驱动器的快捷菜单中。

shell\verb\command=Filename.exe 
shell\verb=MenuText

parameters

  • 谓词

    菜单命令的谓词。 shell\verb\command 条目将谓词与可执行文件相关联。 谓词不得包含嵌入空格。 默认情况下， 谓词 是快捷菜单中显示的文本。

  • Filename.exe

    执行操作的应用程序的路径和文件名。

  • MenuText

    此参数指定快捷菜单中显示的文本。 如果省略它，则显示 谓词 。 MenuText 可以混合大小写，并且可以包含空格。 可以通过在字母前面放置与 (&) 来设置菜单项的快捷键。

备注

当用户右键单击驱动器图标时，将显示快捷菜单。 通过将 shell\verb 条目添加到驱动器的 Autorun.inf 文件，可以将命令添加到此快捷菜单。

此条目有两个部分，它们必须位于单独的行上。 第一部分是 shell\verb\command。 它是必需的。 它将名为 谓词的字符串与运行命令时要启动的应用程序相关联。 第二部分是 shell\**谓词 条目。 它是可选的。 可以包含它以指定在快捷菜单中显示的文本。

若要指定默认快捷菜单命令，请使用 shell\verb 定义谓词，并使用 shell 条目使其成为默认命令。

以下示例 Autorun.inf 片段将 readit 谓词与命令字符串“记事本abc\readme.txt”相关联。 菜单文本为“Read Me”，“M”定义为项的快捷键。 当用户选择此命令时，驱动器的abc\readme.txt文件会打开 Microsoft 记事本。

shell\readit\command=notepad abc\readme.txt 
shell\readit=Read &Me

[内容]钥匙

有三个文件类型键： MusicFiles、 PictureFiles 和 VideoFiles。

如果其中一个内容通过不区分大小写的值 1、y、yes、t 或 true 设置为 true，则自动播放 UI 将显示与该内容类型关联的处理程序，而不管媒体上是否存在该类型的内容。

如果通过不区分大小写的值 0、n、no、f 或 false 将其中一个内容设置为 false，则即使媒体上检测到该内容类型的内容，自动播放 UI 也不会显示与该内容类型关联的处理程序。

使用此部分的目的是允许内容作者将内容的意图传达给自动播放。 例如，CD 可以归类为仅包含音乐内容，即使它也有图片和视频，否则将被视为包含混合内容。

[内容] 部分仅在 Windows Vista 及更高版本下受支持。

[Content]
MusicFiles=Y
PictureFiles=0
VideoFiles=false

[ExclusiveContentPaths]钥匙

本部分中列出的文件夹限制为“自动播放”仅搜索这些文件夹及其子文件夹的内容。 可以使用或不使用前导反斜杠 (\) 。 在任一情况下，它们都被视为媒体根目录中的绝对路径。 如果文件夹名称中包含空格，请不要将它们括在引号中，因为引号从字面上看是作为路径的一部分。

使用此部分的目的是允许内容作者将内容的意图传达给自动播放，并通过将扫描限制为媒体的某些重要区域来缩短其扫描时间。

以下是所有有效路径

[ExclusiveContentPaths]
\music
\music\more music
music2

[ExclusiveContentPaths] 部分仅在 Windows Vista 及更高版本中受支持。

[IgnoreContentPaths]钥匙

搜索媒体内容时，自动播放将忽略本节中列出的文件夹及其子文件夹。 可以使用或不使用前导反斜杠 (\) 。 在任一情况下，它们都被视为媒体根目录中的绝对路径。 如果文件夹名称中包含空格，请不要将它们括在引号中，因为引号从字面上看是作为路径的一部分。

本节中的路径优先于 [ExclusiveContentPaths] 部分中的路径 。 如果 [IgnoreContentPaths] 中给定的路径是 [ExclusiveContentPaths] 中给定路径的子文件夹，则仍会忽略该路径。

使用此部分的目的是允许内容作者将内容的意图传达给自动播放，并通过将扫描限制为媒体的某些重要区域来缩短其扫描时间。

以下是所有有效路径

[IgnoreContentPaths]
\music
\music\more music
music2

[IgnoreContentPaths] 部分仅在 Windows Vista 及更高版本中受支持。

[DeviceInstall]钥匙

DriverPath

DriverPath 条目指定要以递归方式搜索驱动程序文件的目录。 此命令在驱动程序安装期间使用，不是 AutoRun 操作的一部分。 [DeviceInstall] 部分仅在 Windows XP 下受支持。

[DeviceInstall]
DriverPath=directorypath

parameters

  • directorypath

    Windows 搜索驱动程序文件及其所有子目录的目录的路径。

备注

请勿在 目录路径 中使用驱动器号，因为它们从一台计算机更改为下一台计算机。

若要搜索多个目录，请为每个目录添加 DriverPath 条目，如以下示例所示。

[DeviceInstall]
DriverPath=drivers\video 
DriverPath=drivers\audio

如果在 [DeviceInstall] 部分中未提供 DriverPath 条目，或者 DriverPath 条目没有值，则在搜索驱动程序文件时将跳过该驱动器。