Autorun.inf エントリ
このトピックは、Autorun.inf ファイルで使用できるエントリのリファレンスです。 エントリは、キーと値で構成されます。
[自動実行]キー
action
アクション エントリは、メディアの Autorun.inf ファイルの open エントリまたは shellexecute エントリで指定されたプログラムを表すハンドラーの [自動再生] ダイアログで使用されるテキストを指定します。 値は、テキストまたはバイナリに格納されているリソースとして表すことができます。
action=ActionText
action=@[filepath\]filename,-resourceID
パラメーター
ActionText
メディアの Autorun.inf ファイルの open または shellexecute エントリで指定されたプログラムを表すハンドラーの [自動再生] ダイアログで使用されるテキスト。
Filepath
文字列を含むバイナリ ファイルを含むディレクトリの完全修飾パスを含む文字列。 パスを指定しない場合、ファイルはドライブのルート ディレクトリに存在する必要があります。
ファイル名
バイナリ ファイルの名前を含む文字列。
resourceID
バイナリ ファイル内の文字列の ID。
注釈
アクション キーは、Windows XP Service Pack 2 (SP2) 以降でのみ使用されます。 これは、DRIVE_REMOVABLEとDRIVE_FIXEDの種類のドライブでのみサポートされます。 DRIVE_REMOVABLEの場合は、 アクション キーが必要です。 オーディオ CD またはムービー DVD の Autorun.inf ファイル内の アクション コマンドは無視され、これらのメディアは引き続き Windows XP Service Pack 1 (SP1) 以前と同様に動作します。
[自動再生] ダイアログに表示される文字列は、 アクション エントリで指定されたテキストと、シェルによって提供されるプロバイダーに名前を付けるハードコーディングされたテキストを組み合わせることによって構築されます。 アイコンが横に表示されます。 このエントリは常に [自動再生] ダイアログの最初のオプションとして表示され、既定で選択されます。 ユーザーが オプションを受け入れると、メディアの Autorun.inf ファイルの open または shellexecute エントリで指定されたアプリケーションが起動されます。 [ 選択したアクションを常に実行する ] オプションは、この状況では使用できません。
アクション キーとアイコン キーは、エンド ユーザーが [自動再生] ダイアログで表示するアプリケーションの表現を定義します。 ユーザーが簡単に識別できるように構成する必要があります。 実行するアプリケーション、アプリケーションを作成した会社、および関連するブランド化を示す必要があります。
下位互換性のために、 アクション エントリは DRIVE_FIXED 型のデバイスでは省略可能です。 この種類では、Autorun.inf ファイルに アクション エントリが存在しない場合、既定のエントリが [自動再生] ダイアログで使用されます。
アクション エントリは、これまで Autorun.inf をサポートしていなかったDRIVE_REMOVABLE型のデバイスに必須です。 アクション エントリが存在しない場合は、[自動再生] ダイアログが表示されますが、追加のコンテンツを起動するオプションはありません。
CustomEvent
CustomEvent エントリは、カスタムの自動再生コンテンツ イベントを指定します。
CustomEvent=CustomEventName
パラメーター
CustomEventName
AutoPlay コンテンツ イベントの名前を含むテキスト文字列。 名前は 100 文字以下にする必要があります。
注釈
ボリュームの Autorun.inf ファイルにカスタム イベント名を含めることができます。 AutoPlay は、ボリュームで使用するアプリケーションの入力をユーザーに求めると、指定したカスタム イベント名に登録されているアプリケーションのみを表示します。 カスタム自動再生コンテンツ イベントのハンドラーとしてアプリケーションを登録する方法については、「AutoPlay を使用した 自動起動 」または 「イベント ハンドラーを登録する方法」を参照してください。
次の例では、新しい AutoPlay コンテンツ イベントとして値 "MyContentOnArrival" を指定します。
CustomEvent=MyContentOnArrival
icon
アイコン エントリは、Windows ユーザー インターフェイスの自動実行が有効なドライブを表すアイコンを指定します。
icon=iconfilename[,index]
パラメーター
iconfilename
アイコン情報を含む .ico、.bmp、.exe、または.dll ファイルの名前。 ファイルに複数のアイコンが含まれている場合は、アイコンの 0 から始まるインデックスも指定する必要があります。
注釈
アイコンとラベルは、Windows ユーザー インターフェイスの自動実行が有効なドライブを表します。 たとえば、Windows エクスプローラーでは、ドライブは標準のドライブ アイコンではなく、このアイコンで表されます。 アイコンのファイルは、 open コマンドで指定されたファイルと同じディレクトリに存在する必要があります。
次の例では、MyProg.exe ファイルの 2 番目のアイコンを指定します。
icon=MyProg.exe,1
label
ラベル エントリは、Windows ユーザー インターフェイスの自動実行が有効なドライブを表すテキスト ラベルを指定します。
label=LabelText
パラメーター
LabelText
ラベルを含むテキスト文字列。 スペースを含めることができるため、32 文字以内にする必要があります。
注意
LabelText パラメーターに 32 文字を超える値を指定し、エラー メッセージを受け取る必要はありません。 ただし、システムでは最初の 32 文字のみが表示されます。 32 番目以降の文字は切り捨てられ、表示されません。 たとえば、 LabelText が label="This CD is designed to the ultimate music CD" の場合、"This CD is designed to the ul" (この CD は ul として設計されています) と表示されます。
注釈
ラベルとアイコンは、Windows ユーザー インターフェイスの自動実行が有効なドライブを表します。
次の例では、ドライブのラベルとして値 "My Drive Label" を指定します。
label=My Drive Label
開く
開いているエントリは、ユーザーがドライブにディスクを挿入したときに AutoRun が起動するアプリケーションのパスとファイル名を指定します。
open=[exepath\]exefile [param1 [param2] ...]
パラメーター
exefile
CD の挿入時に実行される実行可能ファイルの完全修飾パス。 ファイル名のみを指定する場合は、ドライブのルート ディレクトリに存在する必要があります。 サブディレクトリ内のファイルを見つけるには、パスを指定する必要があります。 また、スタートアップ アプリケーションに渡す 1 つ以上のコマンド ライン パラメーターを含めることもできます。
UseAutoPlay
Windows XP では、 UseAutoPlay エントリは AutoRun の代わりに AutoPlay を使用することを指定します。
Windows Vista 以降では、このエントリにより、AutoRun に指定されたアクション ( 開いている エントリまたは shellexecute エントリのいずれかを使用) が [自動再生] ダイアログから非表示になります。 このエントリは、Windows XP より前のバージョンの Windows には影響しません。
Windows 8 以降では、値 0 を指定すると、このデバイスの自動再生が無効になります。
パラメーター
このオプションを使用するには、 UseAutoPlay のエントリを Autorun.inf ファイルに追加し、エントリを 1 に設定します。 Windows 8より前のバージョンの Windows では、他の値はサポートされていません。
Windows 8 以降では、このデバイスの自動再生を無効にするには、値 0 を指定します。
UseAutoPlay=1
注釈
現時点では、 UseAutoPlay は Windows XP 以降でのみ適用され、 GetDriveType が DRIVE_CDROM 型であると判断したドライブでのみ適用されます。
UseAutoPlay を使用すると、Autorun.inf の open エントリまたは shellexecute エントリで指定されたアクションはすべて Windows XP では無視され、Windows Vista の [自動再生] ダイアログからは省略されます。
AutoRun は通常、挿入されたメディアに含まれるものを自動的に実行または読み込むのに使用されますが、AutoPlay には、実行できる関連アクションの一覧を含むダイアログが表示され、ユーザーは実行するアクションを選択できます。 自動実行と自動再生の違いの詳細については、「 自動実行対応 CD-ROM アプリケーションの作成 」と「 自動再生の使用と構成」を参照してください。
使用例
CD には、Autorun.inf、Readme.txt、Music.wma の 3 つのファイルが含まれています。 使用中の Windows のバージョンと Autorun.inf で指定されたオプションによっては、CD が挿入されるときに AutoRun または AutoPlay によって処理される場合があります (CD が挿入されるドライブに対して AutoRun/AutoPlay が有効になっていると仮定)。
まず、 UseAutoPlay=1 が指定されていないことに関して、次の内容を含む Autorun.inf ファイルを検討します。
[AutoRun]
shellexecute="Readme.txt"
この CD が挿入されたときにシェルによって実行されるアクションは、使用中の Windows のバージョンによって異なります。
- Windows XP 以前では、この CD は挿入時に AutoRun によって処理されます。 この場合、 shellexecute エントリが読み取られ、シェルは.txtファイルに関連付けられているファイル ハンドラーを呼び出します。通常、これはメモ帳でReadme.txtを開きます。
- Windows Vista では、 Shellexecute エントリを含む Autorun.inf ファイルが存在すると、メディアは自動再生の種類 "ソフトウェアとゲーム" として識別されます。 この場合、ユーザーには、 shellexecute エントリで指定されたアクション (ダイアログの [読み込みReadme.txt] として表示されます) と、"ソフトウェアとゲーム" の種類のメディアに関連付けられている既定のアクションを含む自動再生ダイアログが表示されます。
Windows XP で AutoRun ではなく AutoPlay を使用する必要があり、Windows Vista の [自動再生] ダイアログで AutoRun shellexecute エントリで指定されたアクションを抑制する必要があることを示すには、次のように UseAutoPlay を Autorun.inf ファイルに挿入します。
[AutoRun]
shellexecute="Readme.txt"
UseAutoPlay=1
もう一度、この CD の挿入時にシェルによって実行されるアクションは、使用中の Windows のバージョンによって異なります。
- Windows XP より前のバージョンの Windows では、AutoRun が引き続き使用され、 前述のように shellexecute で指定されたアクションが実行されます。 (Windows XP より前のバージョンの Windows では AutoRun のみを使用できます。
- Windows XP では、 UseAutoPlay エントリによって AutoRun の代わりに AutoPlay が使用されます。 この場合、自動再生では、メディアに Windows Media Audio (.wma) ファイルが含まれていると判断され、コンテンツが "Music ファイル" として分類されます。 ユーザーには、"Music files" AutoPlay メディアタイプの登録済みハンドラーを含む自動再生ダイアログが表示されます。AutoRun shellexecute エントリは無視されます。
shellexecute
バージョン 5.0。 shellexecute エントリは、AutoRun が ShellExecuteEx の呼び出しに使用するアプリケーションまたはデータ ファイルを指定します。
shellexecute=[filepath\]filename[param1, [param2]...]
パラメーター
Filepath
データファイルまたは実行可能ファイルを含むディレクトリの完全修飾パスを含む文字列。 パスを指定しない場合、ファイルはドライブのルート ディレクトリに存在する必要があります。
ファイル名
ファイルの名前を含む文字列。 実行可能ファイルの場合は、起動されます。 データ ファイルの場合は、 ファイルの種類のメンバーである必要があります。 ShellExecuteEx は、ファイルの種類に関連付けられている既定のコマンドを起動します。
paramx
ShellExecuteEx に渡す必要がある追加のパラメーターが含まれます。
注釈
このエントリは 開いていると似ていますが、 ファイルの関連付け 情報を使用してアプリケーションを実行できます。
シェル
シェル エントリは、ドライブのショートカット メニューの既定のコマンドを指定します。
shell=verb
パラメーター
Verb
メニュー コマンドに対応する動詞。 動詞とそれに関連付けられているメニュー コマンドは、 shell\verb エントリを使用して Autorun.inf ファイルで定義する必要があります。
注釈
ユーザーがドライブ アイコンを右クリックすると、ショートカット メニューが表示されます。 Autorun.inf ファイルが存在する場合は、既定のショートカット メニュー コマンドがそこから取得されます。 このコマンドは、ユーザーがドライブのアイコンをダブルクリックしたときにも実行されます。
既定のショートカット メニュー コマンドを指定するには、まず、その動詞、コマンド文字列、およびメニュー テキストを shell\verb で定義します。 次に、シェルを使用して、既定のショートカット メニュー コマンドにします。 それ以外の場合、既定のメニュー項目のテキストは "AutoPlay" になり、 開いている エントリで指定されたアプリケーションが起動されます。
shell\verb
shell\verb エントリは、ドライブのショートカット メニューにカスタム コマンドを追加します。
shell\verb\command=Filename.exe
shell\verb=MenuText
パラメーター
Verb
メニュー コマンドの動詞。 shell\verb\command エントリは、動詞を実行可能ファイルに関連付けます。 動詞には、埋め込みスペースを含めることはできません。 既定では、 verb はショートカット メニューに表示されるテキストです。
Filename.exe
アクションを実行するアプリケーションのパスとファイル名。
MenuText
このパラメーターは、ショートカット メニューに表示されるテキストを指定します。 省略すると、 動詞 が表示されます。 MenuText は大文字と小文字が混在し、スペースを含めることができます。 文字の前にアンパサンド (&) を配置することで、メニュー項目のショートカット キーを設定できます。
注釈
ユーザーがドライブ アイコンを右クリックすると、ショートカット メニューが表示されます。 ドライブの Autorun.inf ファイルに shell\verb エントリを追加すると、このショートカット メニューにコマンドを追加できます。
このエントリには 2 つの部分があり、個別の行に配置する必要があります。 最初の部分は shell\verb\command です。 この引数は必須です。 動詞と呼ばれる文字列を、コマンドの実行時に起動するアプリケーションに関連付けます。 2 番目の部分は**shell\**verb エントリです。 これはオプションです。 ショートカット メニューに表示するテキストを指定するために含めることができます。
既定のショートカット メニュー コマンドを指定するには、 shell\verb を使用して動詞を定義し、 シェル エントリを使用して既定のコマンドにします。
次のサンプル Autorun.inf フラグメントは、 readit 動詞をコマンド文字列 "Notepad abc\readme.txt" に関連付けます。 メニュー テキストは "Read Me" で、'M' はアイテムのショートカット キーとして定義されます。 ユーザーがこのコマンドを選択すると、ドライブのabc\readme.txt ファイルが Microsoft メモ帳で開きます。
shell\readit\command=notepad abc\readme.txt
shell\readit=Read &Me
[コンテンツ]キー
ファイルの種類には、 MusicFiles、PictureFiles、 VideoFiles の 3 種類 のキーがあります。
これらのコンテンツの 1 つが大文字と小文字を区別しない値 1、y、yes、t、または true を使用して true に設定されている場合、自動再生 UI は、その種類のコンテンツがメディアに存在するかどうかに関係なく、そのコンテンツ タイプに関連付けられているハンドラーを表示します。
これらのコンテンツの 1 つが 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 エントリは、ドライバー ファイルを再帰的に検索するディレクトリを指定します。 このコマンドは、ドライバーのインストール中に使用され、自動実行操作の一部ではありません。 [DeviceInstall] セクションは、Windows XP でのみサポートされています。
[DeviceInstall]
DriverPath=directorypath
パラメーター
directorypath
Windows がドライバー ファイルを検索し、そのすべてのサブディレクトリを検索するディレクトリへのパス。
注釈
ディレクトリパスのドライブ文字は、あるコンピューターから次のコンピューターに変更されるため、使用しないでください。
複数のディレクトリを検索するには、次の例のように、各ディレクトリの DriverPath エントリを追加します。
[DeviceInstall]
DriverPath=drivers\video
DriverPath=drivers\audio
[DeviceInstall] セクションに DriverPath エントリが指定されていない場合、または DriverPath エントリに値がない場合、ドライバー ファイルの検索中にそのドライブはスキップされます。