共用方式為

.kdfiles （設定驅動程式取代地圖）

  • 發行項

.kdfiles 命令會讀取檔案，並使用其內容作為驅動程式取代對應。

.kdfiles MapFile
.kdfiles -m OldDriver NewDriver
.kdfiles -s SaveFile
.kdfiles -c
.kdfiles

參數

MapFile
指定要讀取的驅動程式取代對應檔案。

-m
將驅動程式取代關聯新增至目前的關聯清單。

OldDriver
指定目標電腦上上一個驅動程式的路徑和檔名。 OldDriver 的語法與驅動程式取代檔案中對應后的第一行語法相同。 如需此語法的詳細資訊，請參閱 對應驅動程序檔案。

NewDriver
指定新驅動程式的路徑和檔名。 此驅動程式可以位於主電腦或其他網路位置。 NewDriver 的語法與驅動程式取代檔案中對應后的第二行語法相同。 如需此語法的詳細資訊，請參閱 對應驅動程序檔案。

-s
建立檔案，並將目前的驅動程式取代關聯寫入該檔案。

SaveFile
指定要建立的檔案名稱。

-c
刪除現有的驅動程式取代對應。 （此選項不會改變對應檔案本身。相反地，此選項會清除調試程式的目前對應設定。

Environment

模式

僅限核心模式

目標

僅限即時偵錯

平台

以 x86 為基礎的處理器

其他資訊

如需驅動程式取代和其他內核模式模組取代範例的詳細資訊、驅動程式取代對應檔案的格式描述，以及使用此功能的限制，請參閱 對應驅動程式檔案。

備註

如果您使用不含參數的 .kdfiles 命令，調試程式會顯示目前驅動程式取代對應檔的路徑和名稱，以及目前的取代關聯集。

當您執行此命令時，會讀取指定的 MapFile檔案。 如果找不到檔案，或未包含正確格式的文字，調試程式會顯示一則訊息，指出「無法載入檔案關聯」。

如果指定的檔案採用正確的驅動程式取代對應檔格式，調試程式會載入檔案的內容，並使用它們作為驅動程式取代對應。 此對應會維持在結束調試程式之前，或直到您發出另一個 .kdfiles 命令為止。

讀取檔案之後，驅動程式取代對應不會受到檔案後續變更的影響（除非這些變更後面接著另一個 .kdfiles 命令）。

使用者模式檔案取代

使用者模式檔案取代已在 Windows 2004 版中新增。 此支援可讓下列使用者模式檔案取代為 .kdfiles。

  • 使用者模式 DLL （也包括 NTDLL 和 KnownDlls）
  • 使用者模式 EXE 是 CreateProcess 的主要進程映像

若要使用使用者模式 .kdfiles 支援，您必須先使用 !gflag +ksl 調試程式命令啟用核心符號載入，或在登錄中設定 ksl 全域旗標。 如需 gflag 的詳細資訊，請參閱 ！gflag。

下列範例說明常見的用法。

.kdfiles -m system32\userdll C:\myfiles\my_native_userdll.dll
.kdfiles -m system32\userdll \\server\share\my_native_userdll.dll
.kdfiles -m syswow64\ntdll.dll \\server\share\my_x86_wow64_ntdll.dll
.kdfiles -m system32\userbase.dll \\server\share\my_native_userbase.dll

使用者模式 .kdfiles 會忽略任何與檔案相符的失敗，而且不會在發生失敗時顯示錯誤訊息。

請小心適當地限定使用者模式 .kdfiles 的 .kdfiles 路徑。 最好只比對ntdll.dll（而不是 system32\ntdll.dll），否則 Wow64 NTDLL 會取代為原生 NTDLL。 其他模棱兩可的子字串相符專案可能會發生類似的情況。

組建 20172 之後，使用者模式 .kdfiles 機制會嘗試從調試程式提取檔案，直到嘗試失敗為止;然後，在調試程式手動介入以修改目標系統狀態的情況下，不會再次嘗試無法提取的檔名。 在先前的組建中，使用者模式 .kdfiles 機制會嘗試每次開機會話提取指定的檔名。。 這些原則可減少與調試程式通訊的額外負荷，以取得不在 kdfiles 清單中的檔案，或因共用可能已載入指定檔案之進程的違規而無法取代的檔案。 由於此行為，通常建議先設定任何檔案以先提取 .kdfiles 清單，再加以參考。

請注意無法取代已在使用磁碟檔案中的限制等等。由於許多系統 DLL 在一開始載入之後不容易進行熱交換，因此預設 gflags +ksl 選項，並使用 .kdfiles 取代開機時的任何使用者模式二進位檔。

如需啟用開機偵錯的詳細資訊，請參閱 BCDEdit /bootdebug。

建議使用高速/低延遲 KD 傳輸 KDNET，將系統效能的影響降到最低。

需求

版本

Windows XP 和更新版本的 Windows 作業系統支援。