Записи Autorun.inf
В этом разделе приведена ссылка на записи, которые можно использовать в файле Autorun.inf. Запись состоит из ключа и значения.
- [AutoRun] Ключи
- [Содержимое] Ключи
- [ExclusiveContentPaths] Ключи
- [IgnoreContentPaths] Ключи
- [DeviceInstall] Ключи
[AutoRun] Ключи
действие
Запись действия указывает текст, используемый в диалоговом окне автозапуска для обработчика, представляющего программу, указанную в записи open или shellexecute в файле Autorun.inf носителя. Значение может быть выражено как текст или как ресурс, хранящийся в двоичном файле.
action=ActionText
action=@[filepath\]filename,-resourceID
Параметры
ActionText
Текст, используемый в диалоговом окне автозапуска для обработчика, представляющего программу, указанную в записи open или shellexecute в файле Autorun.inf носителя.
Filepath
Строка, содержащая полный путь к каталогу, который содержит двоичный файл, содержащий строку. Если путь не указан, файл должен находиться в корневом каталоге диска.
filename
Строка, содержащая имя двоичного файла.
resourceID
Идентификатор строки в двоичном файле.
Замечания
Ключ действия используется только в Windows XP с пакетом обновления 2 (SP2) или более поздней версии. Он поддерживается только для дисков типа DRIVE_REMOVABLE и DRIVE_FIXED. В случае DRIVE_REMOVABLE требуется ключ действия . Команда действия в файле Autorun.inf звукового компакт-диска или DVD-диска фильма игнорируется, и эти носители продолжают вести себя как в Windows XP с пакетом обновления 1 (SP1) и более ранних версий.
Строка, отображаемая в диалоговом окне автозапуска, создается путем объединения текста, указанного в записи действия , с жестко закодированным именем поставщика, предоставленного оболочкой. Рядом с ним отображается значок . Эта запись всегда отображается как первый вариант в диалоговом окне автозапуска и выбран по умолчанию. Если пользователь принимает этот параметр, запускается приложение, указанное открытой записью или записью shellexecute в файле Autorun.inf носителя. Параметр "Всегда делать выбранное действие " недоступен в этой ситуации.
Клавиши действия и значка вместе определяют представление приложения, которое отображается конечным пользователем в диалоговом окне автозапуска. Они должны быть составлены таким образом, чтобы пользователи могли легко идентифицировать их. Они должны указывать на запуск приложения, компанию, созданную им, и любую связанную фирменную символику.
Для обратной совместимости запись действия является необязательной для устройств типа DRIVE_FIXED. Для этого типа запись по умолчанию используется в диалоговом окне автозапуска, если в файле Autorun.inf отсутствует запись действия .
Запись действия является обязательной для устройств типа DRIVE_REMOVABLE, которые до сих пор не поддерживали Autorun.inf. Если запись действия отсутствует, отображается диалоговое окно автозапуска, но без возможности запуска дополнительного содержимого.
CustomEvent
Запись CustomEvent указывает пользовательское событие содержимого Автозапуска.
CustomEvent=CustomEventName
Параметры
CustomEventName
Текстовая строка, содержащая имя события содержимого Автозапуска. Имя должно быть не более 100 буквенно-цифровых символов.
Замечания
Можно включить пользовательское имя события в файл Autorun.inf тома. Когда функция Автозапуск предложит пользователю использовать приложение с томом, оно отображает только приложения, зарегистрированные для указанного пользовательского имени события. Сведения о том, как можно зарегистрировать приложение в качестве обработчика для пользовательского события содержимого Автозапуска, см. в разделе "Автозапуск" с помощью автозапуска или регистрации обработчика событий.
В следующем примере указано значение MyContentOnArrival в качестве нового события содержимого Автозапуска.
CustomEvent=MyContentOnArrival
значок
Запись значка указывает значок , представляющий диск с поддержкой автозапуска в пользовательском интерфейсе Windows.
icon=iconfilename[,index]
Параметры
iconfilename
Имя ICO, BMP, EXE-файла или DLL-файла, содержащего сведения о значке. Если файл содержит несколько значков, необходимо также указать отсчитываемый от нуля индекс значка.
Замечания
Значок вместе с меткой представляет диск с поддержкой автозапуска в пользовательском интерфейсе Windows. Например, в Windows Обозреватель диск представлен этим значком вместо значка стандартного диска. Файл значка должен находиться в том же каталоге, что и файл, указанный открытой командой.
В следующем примере указывается второй значок в файле MyProg.exe.
icon=MyProg.exe,1
label
Запись метки указывает текстовую метку, представляющую диск с поддержкой автозапуска в пользовательском интерфейсе Windows.
label=LabelText
Параметры
LabelText
Текстовая строка, содержащая метку. Он может содержать пробелы и не должен превышать 32 символов.
Примечание.
Можно поместить значение в параметр LabelText , превышающее 32 символов и не получая сообщения об ошибке. Однако система отображает только первые 32 символа. Все символы после 32-го усечены и не отображаются. Например, если LabelText выглядит следующим образом: label="Этот компакт-диск предназначен для конечной музыкальной компакт-диска" будет отображаться следующим образом: "Этот компакт-диск предназначен для ul".
Замечания
Метка вместе с значком представляет диск с поддержкой автозапуска в пользовательском интерфейсе Windows.
В следующем примере указывается значение "Моя метка диска" в качестве метки диска.
label=My Drive Label
открыт
Открытая запись указывает путь и имя файла приложения, запускаемого автоматическим запуском, когда пользователь вставляет диск на диск.
open=[exepath\]exefile [param1 [param2] ...]
Параметры
exefile
Полный путь к исполняемому файлу, который выполняется при вставке компакт-диска. Если указано только имя файла, он должен находиться в корневом каталоге диска. Чтобы найти файл в подкаталоге, необходимо указать путь. Можно также включить один или несколько параметров командной строки для передачи в приложение запуска.
UseAutoPlay
В Windows XP запись UseAutoPlay указывает, что автозапуск должен использоваться вместо автозапуска.
В Windows Vista и более поздних версиях эта запись приводит к тому, что любые действия, указанные для автозапуска (с помощью открытых или оболочки записей), будут отключаться из диалогового окна автозапуска. Эта запись не влияет на версии Windows до Windows XP.
В Windows 8 и более поздних версиях, указывающее значение 0, отключит автоматическое воспроизведение для этого устройства.
Параметры
Чтобы использовать этот параметр, добавьте запись для UseAutoPlay в файл Autorun.inf и задайте для записи значение 1. Другое значение не поддерживается в версиях Windows до Windows 8.
В Windows 8 и более поздних версиях укажите значение 0, чтобы отключить автоматическое воспроизведение для этого устройства.
UseAutoPlay=1
Замечания
В настоящее время UseAutoPlay применяется только в Windows XP или более поздней версии, и только на диске, который GetDriveType определяет тип DRIVE_CDROM.
При использовании UseAutoPlay все действия, указанные открытыми или оболочками, в Autorun.inf игнорируются в Windows XP и опущены в диалоговом окне автозапуска в Windows Vista.
Автозапуск обычно используется для автоматического запуска или загрузки чего-то, содержащегося на вставленном носителе, в то время как autoPlay представляет диалоговое окно, содержащее список соответствующих действий, которые могут быть приняты и позволяют пользователю выбрать, какие действия следует предпринять. Дополнительные сведения о разнице между автозапуском и автозапуском см. в разделе "Создание приложения CD-ROM с поддержкой автозапуска" и "Использование" и "Настройка автозапуска" соответственно.
Пример использования
Компакт-диск содержит три файла: Autorun.inf, Readme.txt и Music.wma. В зависимости от используемой версии Windows и параметров, указанных в Autorun.inf, компакт-диск может обрабатываться автоматическим запуском или автозапуском при вставке (при условии, что для диска, в который вставляется компакт-диск, включен автозапуск или автозапуск).
Сначала рассмотрим файл Autorun.inf со следующим содержимым, отметив, что UseAutoPlay=1 не указан:
[AutoRun]
shellexecute="Readme.txt"
Действие, выполняемое оболочкой при вставке этого компакт-диска, зависит от используемой версии Windows:
- В Windows XP или более ранней версии этот компакт-диск обрабатывается автозапуском при вставке. В этом случае запись shellexecute считывается, и оболочка вызывает обработчик файлов, связанный с txt-файлами, как правило, это открывает Readme.txt в Блокнот.
- В Windows Vista наличие файла Autorun.inf с записью shellexecute приводит к идентификации носителя как типа AutoPlay "Программное обеспечение и игры". В этом случае пользователь предоставляет диалоговое окно автозапуска, включающее действие, указанное записью shellexecute (представленное как Load Readme.txt) в диалоговом окне, а также действия по умолчанию, связанные с типом "Программное обеспечение и игры".
Чтобы указать, что автозапуск должен использоваться вместо автоматического запуска в Windows XP, а действие, указанное записью AutoRun shellexecute, должно быть отключено из диалогового окна автозапуска в Windows Vista, вставьте UseAutoPlay в файл Autorun.inf следующим образом:
[AutoRun]
shellexecute="Readme.txt"
UseAutoPlay=1
Еще раз действие, выполняемое оболочкой при вставке этого компакт-диска, зависит от используемой версии Windows.
- В версиях Windows, предшествующих Windows XP, автозапуск по-прежнему используется, а действие, указанное оболочкой shellexecute , выполняется, как описано ранее. (Обратите внимание, что только автозапуск доступен в версиях Windows, предшествующих Windows XP.)
- В Windows XP запись UseAutoPlay приводит к использованию автозапуска вместо автозапуска. В этом случае Функция автозапуска определяет, что носитель содержит файл звука Windows Media (WMA) и классифицирует содержимое как "Музыкальные файлы". Пользователь отображается с диалоговым окном автозапуска, содержащим зарегистрированные обработчики для типа мультимедиа AutoPlay; Запись AutoRun shellexecute игнорируется.
Shellexecute
Версия 5.0. Запись shellexecute указывает приложение или файл данных, который autoRun будет использовать для вызова ShellExecuteExecuteEx.
shellexecute=[filepath\]filename[param1, [param2]...]
Параметры
Filepath
Строка, содержащая полный путь к каталогу, который содержит данные или исполняемый файл. Если путь не указан, файл должен находиться в корневом каталоге диска.
filename
Строка, содержащая имя файла. Если это исполняемый файл, он запускается. Если это файл данных, он должен быть членом типа файла. ShellExecuteEx запускает команду по умолчанию, связанную с типом файла.
paramx
Содержит все дополнительные параметры, которые должны передаваться в ShellExecuteEx.
Замечания
Эта запись аналогична открытию, но позволяет использовать сведения о сопоставлении файлов для запуска приложения.
оболочка
Запись оболочки указывает команду по умолчанию для контекстного меню диска.
shell=verb
Параметры
Глагол
Команда, соответствующая команде меню. Команда и соответствующая команда меню должны быть определены в файле Autorun.inf с записью shell\verb .
Замечания
Когда пользователь щелкает правой кнопкой мыши значок диска, появится контекстное меню. Если файл Autorun.inf присутствует, команда контекстного меню по умолчанию берется из него. Эта команда также выполняется, когда пользователь дважды щелкает значок диска.
Чтобы указать команду контекстного меню по умолчанию, сначала определите ее команду, командную строку и текст меню с помощью оболочки\verb. Затем используйте оболочку, чтобы сделать ее командой контекстного меню по умолчанию. В противном случае текст элемента меню по умолчанию будет "AutoPlay", который запускает приложение, указанное открытой записью.
shell\verb
Запись shell\verb добавляет настраиваемую команду в контекстное меню диска.
shell\verb\command=Filename.exe
shell\verb=MenuText
Параметры
Глагол
Команда меню. Запись shell\verb\command связывает команду с исполняемым файлом. Команды не должны содержать внедренные пробелы. По умолчанию команда — это текст, отображаемый в контекстном меню.
Filename.exe
Путь и имя файла приложения, выполняющего действие.
MenuText
Этот параметр задает текст, отображаемый в контекстном меню. Если он опущен, отображается команда . MenuText может быть смешанным регистром и может содержать пробелы. Вы можете задать сочетание клавиш для элемента меню, поместив амперсанд (&) перед буквой.
Замечания
Когда пользователь щелкает правой кнопкой мыши значок диска, появится контекстное меню. Добавление записей shell\verb в файл Autorun.inf диска позволяет добавлять команды в это контекстное меню.
Для этой записи есть две части, которые должны находиться в отдельных строках. Первая часть — shell\verb\command. Оно должно указываться обязательно. Он связывает строку, называемую командой, с приложением для запуска при выполнении команды. Вторая часть — запись глагола **shell\**. Этот параметр необязателен. Его можно включить, чтобы указать текст, отображаемый в контекстном меню.
Чтобы указать команду контекстного меню по умолчанию, определите команду с оболочкой\verb и сделайте ее командой по умолчанию с записью оболочки.
Следующий пример фрагмента 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.
Если одно из этих содержимого имеет значение true через одно значение без учета регистра 1, y, да, t или true, пользовательский интерфейс автозапуска отображает обработчики, связанные с этим типом контента, независимо от того, существует ли содержимое этого типа на носителе.
Если одно из этих содержимого имеет значение false через одно значение без учета регистра 0, n, нет, f или false, пользовательский интерфейс автозапуска не отображает обработчики, связанные с этим типом контента, даже если содержимое этого типа обнаружено на носителе.
Использование этого раздела предназначено для предоставления авторам содержимого возможности обмена данными с намерением автозапуска. Например, компакт-диск можно классифицировать как содержащий только музыкальное содержимое, даже если оно также содержит изображения и видео, и в противном случае будет рассматриваться как смешанное содержимое.
Раздел [Содержимое ] поддерживается только в 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 указывает каталог для рекурсивного поиска файлов драйверов. Эта команда используется во время установки драйвера и не является частью операции автозапуска. Раздел [DeviceInstall] поддерживается только в Windows XP.
[DeviceInstall]
DriverPath=directorypath
Параметры
Directorypath
Путь к каталогу, который Windows ищет файлы драйверов, а также все его подкаталоги.
Замечания
Не используйте буквы дисков в directorypath , так как они изменяются с одного компьютера на следующий.
Чтобы выполнить поиск по нескольким каталогам, добавьте запись DriverPath для каждого каталога, как в этом примере.
[DeviceInstall]
DriverPath=drivers\video
DriverPath=drivers\audio
Если запись DriverPath не указана в разделе [DeviceInstall] или запись DriverPath не имеет значения, то этот диск пропускается во время поиска файлов драйверов.