IXtfConsoleControlClient::GenerateStackDump
Gera um despejo de pilha.Sintaxe
Parâmetros
ProcessIdTipo: UINT32 O identificador do processo para o qual criar o despejo de pilha. DumpType
Tipo: UINT32 O tipo de despejo de pilha a ser criado. Os tipos de despejo válidos são:
ImageName
Tipo: LPCWSTR O nome da imagem. FilePath
Tipo: LPBSTR Um ponteiro para uma cadeia de caracteres que recebe o caminho do arquivo de despejo de pilha criado.
Valor retornado
Tipo: HRESULT RetornaS_OK se for bem-sucedido; caso contrário, retorna um código de erro HRESULT. Se o tempo limite da função se esgotar enquanto aguarda a conclusão de um despejo de pilha, essa função retornará E_MESSAGE_TIMED_OUT.
Comentários
Essa função gera um despejo de pilha de um processo especificado para uma imagem executável no console de desenvolvimento. O despejo de pilha é salvo como um arquivo na unidade de rascunho do console, no caminho de arquivo retornado emFilePath.
As informações capturadas pelo despejo de pilha, e o tempo necessário para capturá-las, dependem do tipo de despejo especificado em DumpType. O tempo limite dessa função se esgota após 5 minutos; se um despejo de pilha não for retornado pelo console antes que o tempo limite da função se esgote, essa função retornará E_MESSAGE_TIMED_OUT. A tabela a seguir descreve as informações retornadas por cada tipo de despejo de pilha.
Para obter mais informações sobre as APIs de ferramentas e automação disponíveis, como o XBOX Tools Framework (XTF), confira APIs de ferramentas e automação (tópico NDA).
Manipulando ponteiros LPBSTR
Para obter mais informações sobre como manipular os ponteiros LPBSTR retornados por essa função, confira Alocando e liberando memória para um BSTR.Requisitos
Cabeçalho: xtfconsolecontrol.h Biblioteca: xtfconsolecontrol.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)Confira também
XtfConsoleControlXBOX Tools Framework