IXtfConsoleControlClient::GenerateStackDump
產生堆疊傾印。語法
參數
ProcessId類型：UINT32 要為其建立堆疊傾印之處理序的識別碼。 DumpType
類型：UINT32 要建立的堆疊傾印類型。有效的傾印類型如下：
ImageName
類型：LPCWSTR 映像的名稱。 FilePath
類型：LPBSTR 指向字串的指標，該字串會接收所建立之堆疊傾印檔案的檔案路徑。
傳回值
類型：HRESULT 如果成功，則傳回S_OK；否則傳回 HRESULT 錯誤碼。如果函式在等待堆疊傾印完成時逾時，此函式會傳回 E_MESSAGE_TIMED_OUT。
備註
此函式會針對開發主機上的可執行映像，從指定的處理序產生堆疊傾印。堆疊傾印會以檔案形式儲存在主機的暫存磁碟機上，位於FilePath 中所傳回的檔案路徑。
堆疊傾印所擷取的資訊以及擷取該資訊所需的時間，取決於 DumpType 中指定的傾印類型。此函式會在 5 分鐘後逾時；如果主機在函式逾時之前未傳回堆疊傾印，此函式會傳回 E_MESSAGE_TIMED_OUT。下表說明每種堆疊傾印類型所傳回的資訊。
如需可用工具與自動化 API (例如 XBOX Tools Framework (XTF)) 的詳細資訊，請參閱工具與自動化 API (NDA 主題)。
處理 LPBSTR 指標
如需處理此函式所傳回之 LPBSTR 指標的詳細資訊，請參閱為 BSTR 配置及釋放記憶體。需求
標頭： xtfconsolecontrol.h 程式庫： xtfconsolecontrol.lib 支援的平台： Windows (適用於 XBOX 主機工具)另請參閱
XtfConsoleControlXBOX Tools Framework