.printf

.printf 令牌的行為就像 C 中的 printf 語句。

.printf [/D] [Option] "FormatString" [, Argument , ...]

語法元素

/D
指定格式字串包含調試程式標記語言（DML）。

選擇
（僅限 WinDbg）指定 WinDbg 應該將 FormatString 解譯為的文字訊息類型。 WinDbg 會指派每種類型的調試程式命令視窗訊息背景和文字色彩;選擇其中一個選項會導致訊息以適當的色彩顯示。預設值是將文字顯示為一般層級的訊息。

可用選項如下。

FormatString
指定格式字串，如 printf 所示。一般而言，轉換字元的運作方式與 C 完全相同。如果是浮點轉換字元，除非 使用 l 修飾詞，否則 64 位自變數會解譯為 32 位浮點數。

您可以加入「I64」修飾詞，以指出值應該解譯為 64 位。例如，“%I64x” 可用來列印 64 位十六進位數位。

支援 %p 轉換字元，但它代表目標虛擬位址空間中的指標。它不得有任何修飾詞，而且它使用調試程式的內部位址格式。除了標準 printf 樣式格式規範之外，還支援下列額外的轉換字元。

字元	引數類型	Argument	列印的文字
%p	ULONG64	目標虛擬位址空間中的指標。	指標的值。
%N	DWORD_PTR （32 或 64 位，視主機的架構而定）	主機虛擬位址空間中的指標。	指標的值。（這相當於標準 C %p 字元。）
%馬	ULONG64	目標虛擬位址空間中以 NULL 終止的 ASCII 字串位址。	指定的字串。
%mu	ULONG64	目標虛擬位址空間中以 NULL 終止的 Unicode 字串位址。	指定的字串。
%msa	ULONG64	目標虛擬位址空間中ANSI_STRING結構的位址。	指定的字串。
%msu	ULONG64	目標虛擬位址空間中UNICODE_STRING結構的位址。	指定的字串。
%y	ULONG64	目標虛擬位址空間中的調試程式符號位址。	字串，包含指定符號的名稱（如果有的話則為位移）。
%ly	ULONG64	目標虛擬位址空間中的調試程式符號位址。	字串，包含指定符號的名稱（以及任何位移，如果有的話），以及任何可用的源行資訊。

參數
指定格式字串的自變數，如 printf 所示。指定的自變數數目應該符合 FormatString 中的轉換字元數目。每個自變數都是由預設表達式評估工具（MASM 或 C++）評估的運算式。如需詳細資訊，請參閱數值表達式語法。

如需其他控制流程令牌及其在調試程式命令程式中使用的資訊，請參閱使用調試程式命令程式。

您可以使用 Options 參數選擇的色彩設定預設都是設定為白色背景上的黑色文字。若要充分利用這些選項，您必須先使用 View |開啟 [選項 ] 對話框的選項，並變更 [調試程式命令] 視窗訊息的色彩設定。

下列範例示範如何在格式字串中包含 DML 標籤。

.printf /D "Click <link cmd=\".chain /D\">here</link> to see extensions DLLs."

命令瀏覽器視窗中 DML 連結的螢幕快照。

上圖中顯示的輸出有一個連結，您可以按下以執行標記中指定的 <link> 命令。下圖顯示按兩下連結的結果。

命令瀏覽器視窗中 DML 輸出的螢幕快照。

如需 DML 標籤的相關信息，請參閱 Windows 偵錯工具安裝資料夾中的dml.doc。