Entradas autorun.inf
Este tema es una referencia para las entradas que se pueden usar en un archivo Autorun.inf. Una entrada consta de una clave y un valor.
- [Autoejecutar] Llaves
- [Contenido] Llaves
- [ExclusiveContentPaths] Llaves
- [IgnoreContentPaths] Llaves
- [DeviceInstall] Llaves
[Autoejecutar] Llaves
action
La entrada de acción especifica el texto que se usa en el cuadro de diálogo Reproducción automática para el controlador que representa el programa especificado en la entrada open o shellexecute en el archivo Autorun.inf del medio. El valor se puede expresar como texto o como un recurso almacenado en un binario.
action=ActionText
action=@[filepath\]filename,-resourceID
Parámetros
ActionText
Texto que se usa en el cuadro de diálogo Reproducción automática para el controlador que representa el programa especificado en la entrada open o shellexecute en el archivo Autorun.inf del medio.
Filepath
Cadena que contiene la ruta de acceso completa del directorio que contiene el archivo binario que contiene la cadena. Si no se especifica ninguna ruta de acceso, el archivo debe estar en el directorio raíz de la unidad.
filename
Cadena que contiene el nombre del archivo binario.
resourceID
Identificador de la cadena dentro del archivo binario.
Comentarios
La clave de acción solo se usa en Windows XP Service Pack 2 (SP2) o posterior. Solo se admite para unidades de tipo DRIVE_REMOVABLE y DRIVE_FIXED. En el caso de DRIVE_REMOVABLE, se requiere la clave de acción . Se omite un comando de acción en el archivo Autorun.inf de un CD de audio o DVD de película, y estos medios continúan comportándose como en Windows XP Service Pack 1 (SP1) y versiones anteriores.
La cadena que se muestra en el cuadro de diálogo Reproducción automática se construye combinando el texto especificado en la entrada de acción con texto codificado de forma rígida que asigna el nombre al proveedor, proporcionado por el Shell. El icono se muestra junto a él. Esta entrada siempre aparece como la primera opción del cuadro de diálogo Reproducción automática y está seleccionada de forma predeterminada. Si el usuario acepta la opción , se inicia la aplicación especificada por la entrada open o shellexecute en el archivo Autorun.inf del medio. La opción Siempre realiza la acción seleccionada no está disponible en esta situación.
Las teclasde icono y acción definen juntos la representación de la aplicación que ve el usuario final en el cuadro de diálogo Reproducción automática. Se deben componer de tal manera que los usuarios puedan identificarlos fácilmente. Deben indicar que la aplicación se va a ejecutar, la empresa que la creó y cualquier personalización de marca asociada.
Para la compatibilidad con versiones anteriores, la entrada de acción es opcional para los dispositivos de tipo DRIVE_FIXED. Para este tipo, se usa una entrada predeterminada en el cuadro de diálogo Reproducción automática si no hay ninguna entrada de acción presente en el archivo Autorun.inf.
La entrada de acción es obligatoria para los dispositivos de tipo DRIVE_REMOVABLE, que hasta ahora no tenían compatibilidad con Autorun.inf. Si no hay ninguna entrada de acción , se muestra el cuadro de diálogo Reproducción automática, pero sin opción para iniciar el contenido adicional.
CustomEvent
La entrada CustomEvent especifica un evento de contenido de Reproducción automática personalizado.
CustomEvent=CustomEventName
Parámetros
CustomEventName
Cadena de texto que contiene el nombre del evento de contenido de Reproducción automática. El nombre no debe tener más de 100 caracteres alfanuméricos.
Comentarios
Puede incluir un nombre de evento personalizado en el archivo Autorun.inf de un volumen. Cuando Reproducción automática solicita al usuario que use una aplicación con el volumen, muestra solo las aplicaciones que se han registrado para el nombre de evento personalizado especificado. Para obtener información sobre cómo puede registrar una aplicación como controlador para el evento de contenido de Reproducción automática personalizada, consulte Inicio automático con Reproducción automática o Registro de un controlador de eventos.
En el ejemplo siguiente se especifica el valor "MyContentOnArrival" como un nuevo evento de contenido de Reproducción automática.
CustomEvent=MyContentOnArrival
icon
La entrada de icono especifica un icono que representa la unidad habilitada para autoejecutar en la interfaz de usuario de Windows.
icon=iconfilename[,index]
Parámetros
iconfilename
Nombre de un archivo .ico, .bmp, .exe o .dll que contiene la información del icono. Si un archivo contiene más de un icono, también debe especificar el índice de base cero del icono.
Comentarios
El icono, junto con la etiqueta , representa la unidad habilitada para autoejecutar en la interfaz de usuario de Windows. Por ejemplo, en el Explorador de Windows, la unidad se representa mediante este icono en lugar del icono de unidad estándar. El archivo del icono debe estar en el mismo directorio que el archivo especificado por el comando open .
En el ejemplo siguiente se especifica el segundo icono del archivo MyProg.exe.
icon=MyProg.exe,1
etiqueta
La entrada de etiqueta especifica una etiqueta de texto que representa la unidad habilitada para autoejecutar en la interfaz de usuario de Windows.
label=LabelText
Parámetros
LabelText
Cadena de texto que contiene la etiqueta. Puede contener espacios y no debe tener más de 32 caracteres.
Nota
Es posible colocar un valor en el parámetro LabelText que supere los 32 caracteres y no reciba ningún mensaje de error. Sin embargo, el sistema solo muestra los primeros 32 caracteres. Los caracteres después de la 32ª se truncan y no se muestran. Por ejemplo, si LabelText es el siguiente: label="Este CD está diseñado para ser el CD de música final". Se mostrará lo siguiente, "Este CD está diseñado para ser el ul".
Comentarios
La etiqueta, junto con un icono, representa la unidad habilitada para autoejecutar en la interfaz de usuario de Windows.
En el ejemplo siguiente se especifica el valor "My Drive Label" (Mi etiqueta de unidad) como etiqueta de la unidad.
label=My Drive Label
abrir
La entrada abierta especifica la ruta de acceso y el nombre de archivo de la aplicación que Se inicia AutoRun cuando un usuario inserta un disco en la unidad.
open=[exepath\]exefile [param1 [param2] ...]
Parámetros
exefile
Ruta de acceso completa de un archivo ejecutable que se ejecuta cuando se inserta el CD. Si solo se especifica un nombre de archivo, debe estar en el directorio raíz de la unidad. Para buscar el archivo en un subdirectorio, debe especificar una ruta de acceso. También puede incluir uno o varios parámetros de línea de comandos para pasar a la aplicación de inicio.
UseAutoPlay
En Windows XP, la entrada UseAutoPlay especifica que se debe usar Reproducción automática en lugar de Ejecutar automáticamente.
En Windows Vista y versiones posteriores, esta entrada hace que las acciones especificadas para AutoRun (mediante las entradas open o shellexecute ) se supriman del cuadro de diálogo Reproducción automática. Esta entrada no tiene ningún efecto en las versiones de Windows anteriores a Windows XP.
En Windows 8 y versiones posteriores, al especificar un valor de 0, se deshabilitará la reproducción automática para este dispositivo.
Parámetros
Para usar esta opción, agregue una entrada para UseAutoPlay al archivo Autorun.inf y establezca la entrada igual a 1. No se admite ningún otro valor en versiones de Windows anteriores a Windows 8.
En Windows 8 y versiones posteriores, especifique un valor de 0 para deshabilitar la reproducción automática para este dispositivo.
UseAutoPlay=1
Comentarios
Actualmente, UseAutoPlay solo se aplica en Windows XP o versiones posteriores y solo en una unidad que GetDriveType determina que es de tipo DRIVE_CDROM.
Cuando se usa UseAutoPlay , cualquier acción especificada por las entradas abiertas o shellexecute en Autorun.inf se omite en Windows XP y se omite del cuadro de diálogo Reproducción automática en Windows Vista.
La ejecución automática se usa normalmente para ejecutar o cargar automáticamente algo contenido en el medio insertado, mientras que Reproducción automática presenta un cuadro de diálogo que incluye una lista de las acciones pertinentes que se pueden realizar y permite al usuario elegir qué acción realizar. Para obtener más información sobre la diferencia entre Ejecución automática y Reproducción automática, consulte Creación de una aplicación de CD-ROM habilitada para autoejecutación y Uso y configuración de reproducción automática, respectivamente.
Ejemplo de uso
Un CD contiene tres archivos: Autorun.inf, Readme.txt y Music.wma. Según la versión de Windows en uso y las opciones especificadas en Autorun.inf, el CD se puede controlar mediante AutoRun o AutoPlay cuando se inserta (suponiendo que AutoRun/AutoPlay esté habilitado para la unidad en la que se inserta el CD).
En primer lugar, considere un archivo Autorun.inf con el siguiente contenido, teniendo en cuenta que No se especifica UseAutoPlay=1 :
[AutoRun]
shellexecute="Readme.txt"
La acción realizada por el Shell cuando se inserta este CD depende de la versión de Windows en uso:
- En Windows XP o versiones anteriores, este CD se controla mediante AutoRun cuando se inserta. En este caso, se lee la entrada shellexecute y shell invoca el controlador de archivos asociado a .txt archivos; normalmente, esto abriría Readme.txt en el Bloc de notas.
- En Windows Vista, la presencia de un archivo Autorun.inf con una entrada shellexecute hace que el medio se identifique como tipo de reproducción automática "Software y juegos". En este caso, el usuario se presenta un cuadro de diálogo de Reproducción automática que incluye la acción especificada por la entrada shellexecute (presentada como "Cargar Readme.txt" en el cuadro de diálogo), junto con acciones predeterminadas asociadas a medios de tipo "Software y juegos".
Para indicar que se debe usar Reproducción automática en lugar de Ejecutar automáticamente en Windows XP, y que la acción especificada por la entrada Shellexecute AutoRun debe suprimirse del cuadro de diálogo Reproducción automática en Windows Vista, inserte UseAutoPlay en el archivo Autorun.inf como se indica a continuación:
[AutoRun]
shellexecute="Readme.txt"
UseAutoPlay=1
Una vez más, la acción realizada por el Shell cuando se inserta este CD depende de la versión de Windows en uso.
- En versiones de Windows anteriores a Windows XP, se sigue usando AutoRun y se realiza la acción especificada por shellexecute , como se ha descrito anteriormente. (Tenga en cuenta que solo AutoRun está disponible en versiones de Windows anteriores a Windows XP).
- En Windows XP, la entrada UseAutoPlay hace que la reproducción automática se use en lugar de autoejecutar. En este caso, Reproducción automática determina que el medio contiene un archivo de Audio de Windows Media (.wma) y clasifica el contenido como "Archivos de música". El usuario se presenta un cuadro de diálogo de Reproducción automática que contiene controladores registrados para el tipo de medio de reproducción automática "Archivos de música"; Se omite la entrada Shellexecute de AutoRun.
shellexecute
Versión 5.0. La entrada shellexecute especifica una aplicación o un archivo de datos que AutoRun usará para llamar a ShellExecuteEx.
shellexecute=[filepath\]filename[param1, [param2]...]
Parámetros
Filepath
Cadena que contiene la ruta de acceso completa del directorio que contiene los datos o el archivo ejecutable. Si no se especifica ninguna ruta de acceso, el archivo debe estar en el directorio raíz de la unidad.
filename
Cadena que contiene el nombre del archivo. Si es un archivo ejecutable, se inicia. Si es un archivo de datos, debe ser miembro de un tipo de archivo. ShellExecuteEx inicia el comando predeterminado asociado al tipo de archivo.
paramx
Contiene los parámetros adicionales que se deben pasar a ShellExecuteEx.
Comentarios
Esta entrada es similar a abierta, pero permite usar la información de asociación de archivos para ejecutar la aplicación.
shell
La entrada de shell especifica un comando predeterminado para el menú contextual de la unidad.
shell=verb
Parámetros
Verbo
Verbo que corresponde al comando de menú. El verbo y su comando de menú asociado deben definirse en el archivo Autorun.inf con una entrada shell\verb .
Comentarios
Cuando un usuario hace clic con el botón derecho en el icono de unidad, aparece un menú contextual. Si hay un archivo Autorun.inf presente, el comando de menú contextual predeterminado se toma de él. Este comando también se ejecuta cuando el usuario hace doble clic en el icono de la unidad.
Para especificar el comando de menú contextual predeterminado, primero defina su verbo, cadena de comandos y texto de menú con shell\verb. A continuación, use shell para convertirlo en el comando de menú contextual predeterminado. De lo contrario, el texto del elemento de menú predeterminado será "Reproducción automática", que inicia la aplicación especificada por la entrada abierta .
shell\verbo
La entrada shell\verb agrega un comando personalizado al menú contextual de la unidad.
shell\verb\command=Filename.exe
shell\verb=MenuText
Parámetros
Verbo
Verbo del comando de menú. La entrada shell\verb\command asocia el verbo a un archivo ejecutable. Los verbos no deben contener espacios incrustados. De forma predeterminada, el verbo es el texto que se muestra en el menú contextual.
Filename.exe
Ruta de acceso y nombre de archivo de la aplicación que realiza la acción.
MenuText
Este parámetro especifica el texto que se muestra en el menú contextual. Si se omite, se muestra el verbo . MenuText puede ser de mayúsculas y minúsculas mixtas y puede contener espacios. Puede establecer una tecla de método abreviado para el elemento de menú colocando una y comercial (&) delante de la letra.
Comentarios
Cuando un usuario hace clic con el botón derecho en el icono de unidad, aparece un menú contextual. Agregar entradas shell\verb al archivo Autorun.inf de la unidad permite agregar comandos a este menú contextual.
Hay dos partes en esta entrada, que deben estar en líneas independientes. La primera parte es shell\verb\command. Es obligatorio. Asocia una cadena, denominada verbo, con la aplicación para iniciarse cuando se ejecuta el comando. La segunda parte es la entrada **shell\**verb . Es opcional. Puede incluirlo para especificar el texto que se muestra en el menú contextual.
Para especificar un comando de menú contextual predeterminado, defina el verbo con shell\verb y consértelo con la entrada del shell .
El fragmento Autorun.inf de ejemplo siguiente asocia el verbo readit con la cadena de comando "Bloc de notas abc\readme.txt". El texto del menú es "Read Me" y "M" se define como la tecla de método abreviado del elemento. Cuando el usuario selecciona este comando, el archivo abc\readme.txt de la unidad se abre con el Bloc de notas de Microsoft.
shell\readit\command=notepad abc\readme.txt
shell\readit=Read &Me
[Contenido] Llaves
Hay tres claves de tipo de archivo: MusicFiles, PictureFiles y VideoFiles.
Si uno de estos contenidos se establece en true a través de uno de los valores que no distinguen mayúsculas de minúsculas 1, y, sí, t o true, la interfaz de usuario de Reproducción automática muestra los controladores asociados a ese tipo de contenido, independientemente de si el contenido de ese tipo existe en el medio.
Si uno de estos contenidos se establece en false a través de uno de los valores que no distinguen mayúsculas de minúsculas 0, n, no, f o false, la interfaz de usuario de Reproducción automática no muestra los controladores asociados a ese tipo de contenido aunque se detecte contenido de ese tipo en el medio.
El uso de esta sección está pensado para permitir que los autores de contenido comuniquen la intención del contenido a Reproducción automática. Por ejemplo, un CD se puede clasificar como que contiene solo contenido de música, aunque también tenga imágenes y vídeos y, de lo contrario, se verá como tener contenido mixto.
La sección [Contenido] solo se admite en Windows Vista y versiones posteriores.
[Content]
MusicFiles=Y
PictureFiles=0
VideoFiles=false
[ExclusiveContentPaths] Llaves
Las carpetas enumeradas en esta sección limitan reproducción automática a buscar solo esas carpetas y sus subcarpetas para el contenido. Se pueden proporcionar con o sin una barra diagonal inversa inicial (\). En cualquier caso, se toman como rutas de acceso absolutas desde el directorio raíz del medio. En el caso de las carpetas con espacios en sus nombres, no las incluya entre comillas, ya que las comillas se toman literalmente como parte de la ruta de acceso.
El uso de esta sección está pensado para permitir a los autores de contenido comunicar la intención del contenido a Reproducción automática y acortar su tiempo de examen limitando el examen a determinadas áreas significativas del medio.
A continuación se muestran todas las rutas de acceso válidas.
[ExclusiveContentPaths]
\music
\music\more music
music2
La sección [ExclusiveContentPaths] solo se admite en Windows Vista y versiones posteriores.
[IgnoreContentPaths] Llaves
Las carpetas enumeradas en esta sección y sus subcarpetas se omiten mediante reproducción automática al buscar contenido en un medio. Se pueden proporcionar con o sin una barra diagonal inversa inicial (\). En cualquier caso, se toman como rutas de acceso absolutas desde el directorio raíz del medio. En el caso de las carpetas con espacios en sus nombres, no las incluya entre comillas, ya que las comillas se toman literalmente como parte de la ruta de acceso.
Las rutas de acceso de esta sección tienen prioridad sobre las rutas de acceso de la sección [ExclusiveContentPaths]. Si una ruta de acceso especificada en [IgnoreContentPaths] es una subcarpeta de una ruta de acceso especificada en [ExclusiveContentPaths], se sigue ignorando.
El uso de esta sección está pensado para permitir a los autores de contenido comunicar la intención del contenido a Reproducción automática y acortar su tiempo de examen limitando el examen a determinadas áreas significativas del medio.
A continuación se muestran todas las rutas de acceso válidas.
[IgnoreContentPaths]
\music
\music\more music
music2
La sección [IgnoreContentPaths] solo se admite en Windows Vista y versiones posteriores.
[DeviceInstall] Llaves
DriverPath
La entrada DriverPath especifica un directorio para buscar de forma recursiva los archivos de controlador. Este comando se usa durante una instalación del controlador y no forma parte de una operación autoejecutar. La sección [DeviceInstall] solo se admite en Windows XP.
[DeviceInstall]
DriverPath=directorypath
Parámetros
directorypath
Ruta de acceso a un directorio que Windows busca archivos de controlador, junto con todos sus subdirectorios.
Comentarios
No use letras de unidad en directorypath a medida que cambien de un equipo a otro.
Para buscar varios directorios, agregue una entrada DriverPath para cada directorio como en este ejemplo.
[DeviceInstall]
DriverPath=drivers\video
DriverPath=drivers\audio
Si no se proporciona ninguna entrada DriverPath en la sección [DeviceInstall] o la entrada DriverPath no tiene ningún valor, esa unidad se omite durante una búsqueda de archivos de controlador.