INF DestinationDirs 區塊

DestinationDirs 區段指定所有在 INF 檔案中以名稱參考的檔案的複製、刪除及/或重命名操作的目標目錄或目錄。

[DestinationDirs]

[DefaultDestDir=dirid[,subdir]] 
[file-list-section=dirid[,subdir]]... 

Entries

DefaultDestDir=dirid[,subdir]
指定所有未明確列入檔案 清單區段 (其他條目所引用)檔案的複製、刪除及/或重命名操作的預設目的地目錄。 為確保檔案操作總是發生在正確的目錄中,包含 包含 Include 與 Needs 條目的 INF 檔案不應指定預設的目的目錄。 如需詳細資訊,請參閱下列 [備註] 一節。

檔案列表區段=Dirid[,subdir]] ...
指定由 INF 撰寫者決定的區段名稱,該區段由 INF 檔案中其他地方的 CopyFiles、 RenFiles 或 DelFiles 指令所參考。 若本節有 DefaultDestDir 條目,且所有 INF 指定複製檔操作皆為相同目標目的地,則該條目為可選。 然而,任何由 INF 其他地方 RenFiles 或 DelFiles 指令引用的檔案清單區段,必須在此列出。

迪里德
指定目標目錄的目錄識別碼,用於對以名稱參考的檔案操作,可能位於 INF 的命名 檔案清單區段 內。 關於常用 Dirids的列表,請參見 「Using Dirids」。 在 Windows 10 版本 1709 及之後版本的 Windows 上,建議使用 DIRID 13。 更多資訊請參閱 「駕駛員商店的跑步 」。

副迪爾
指定子目錄(以及由 dirid 識別的目錄下其餘路徑)為該 檔案清單區段中檔案操作的目的地。

Remarks

DestinationDirs 區段是任何使用 INF CopyFiles 指令或參考檔案清單區段的 INF 檔案中必不可少的,無論是使用 CopyFiles、DelFiles 或 RenFiles 指令。

如果 Abc.inf 包含來自另一個 INF 檔案 Def.inf 的區段,且兩個 INF 檔案都包含 DefaultDestDir 的複製檔案、重命名檔案或刪除檔案操作,Windows 會忽略 Def.inf 中指定的預設目的地目錄,並執行所有對應的檔案操作,該目錄由 Abc.inf 指定。

為確保檔案操作總是發生在正確的目錄中,包含 Include 與 Needs 條目的 INF 檔案不應在 DestinationDirs 區段中包含 DefaultDestDir 條目。 相反地,這類 INF 檔案應明確參考 DestinationDirs 區段中由 CopyFiles、RenFiles 和 DelFiles 指令指定的所有檔案列表區段名稱。

如果 INF 檔案沒有包含 Include 和 Needs 的條目,INF 可以使用 DefaultDestDir 條目來指定一個預設的目的地,用於複製、重新命名和刪除檔案操作,這些操作會出現在 INF 檔案的其他地方:

  • 使用 direct copy(@filename) 表示的 CopyFiles 指令,必須在 INF 的 DestinationDirs 區塊中有一個 DefaultDestDir 條目,該條目會出現直接複製條目。
  • CopyFiles、RenFiles 或 DelFiles 區段若未直接在 DestinationDirs 區段中引用,必須在 INF 的 DestinationDirs 區塊中有一個 DefaultDestDir 條目,該區塊會出現複製、重新命名和刪除檔案區段。

Examples

此範例設定了所有複製檔案、刪除檔案及重命名檔案操作的預設目標目錄。 這種簡單的 DestinationDirs 區段在新設備的 INF 檔案中很常見,因為這類 INF 通常只是將一組來源檔案複製到目標電腦的單一目錄中。

[DestinationDirs]
DefaultDestDir = 13

此範例展示了 INF 中顯示/視訊驅動程式 DestinationDirs 部分的一段。

[DestinationDirs]
DefaultDestDir     = 13

; ... 

; list of per-Manufacturer, per-Models, per-DDInstall-section, and
; CopyFiles-referenced xxx.Miniport/xxx.Display sections omitted here
; along with several other miniport/display paired drivers
; ...
vga.Miniport     = 13
vga.Display      = 13
xga.Miniport     = 13
xga.Display      = 13

也請參閱

複製檔案

DDInstall

德爾檔案

RenFiles

SourceDisks檔案

來源磁碟名稱

使用 Dirids