.kdfiles (設定驅動程式取代對應)

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

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

參數

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

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

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

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

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

SaveFile
指定要建立的檔案名。

-C
刪除現有的驅動程式取代對應。 (此選項不會改變對應檔案本身。相反地，此選項會清除偵錯工具的目前對應設定。)

環境

模式	僅限核心模式
目標	僅限即時偵錯
平台	以 x86 為基礎的處理器

其他資訊

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

備註

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

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

如果指定的檔案採用正確的驅動程式取代對應檔案格式，偵錯工具會載入檔案的內容，並使用它們作為驅動程式取代對應。 此對應會保留到您結束偵錯工具，或直到發出另一個 .kdfiles 命令為止。

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

使用者模式檔案取代

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

• 使用者模式 DLL (也包括 NTDLL 和 KnownDlls)
• User mode EXE that are a main process image for 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 會取代為原生。 其他模棱兩可的子字串相符專案可能會發生類似的情況。

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

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

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

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

規格需求

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