IXtfConsoleControlClient::GenerateStackDump
Genera un volcado de pila.Sintaxis
Parámetros
ProcessIdTipo: UINT32 El identificador del proceso para el que se crea el volcado de pila. DumpType
Tipo: UINT32 El tipo de volcado de pila que se va a crear. Los tipos de volcado válidos son:
ImageName
Tipo: LPCWSTR El nombre de la imagen. FilePath
Tipo: LPBSTR Un puntero a una cadena que recibe la ruta de acceso del archivo de volcado de pila creado.
Valor devuelto
Tipo: HRESULT DevuelveS_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT. Si la función agota el tiempo de espera mientras espera a que se complete un volcado de pila, esta función devuelve E_MESSAGE_TIMED_OUT.
Comentarios
Esta función genera un volcado de pila desde un proceso especificado para una imagen ejecutable en la consola de desarrollo. El volcado de pila se guarda como un archivo en la unidad de trabajo de la consola, en la ruta de acceso devuelta enFilePath.
La información capturada por el volcado de pila, y el tiempo que se tarda en capturar esa información, dependen del tipo de volcado especificado en DumpType. Esta función agota el tiempo de espera después de 5 minutos; si la consola no devuelve un volcado de pila antes de que la función agote el tiempo de espera, esta función devuelve E_MESSAGE_TIMED_OUT. La tabla siguiente describe la información devuelta por cada tipo de volcado de pila.
Para obtener más información sobre las API de herramientas y automatización disponibles, como XBOX Tools Framework (XTF), consulte API de herramientas y automatización (tema NDA).
Control de punteros LPBSTR
Para obtener más información sobre el control de los punteros LPBSTR devueltos por esta función, consulte Asignación y liberación de memoria para un BSTR.Requisitos
Encabezado: xtfconsolecontrol.h Biblioteca: xtfconsolecontrol.lib Plataformas compatibles: Windows (para herramientas de consola XBOX)Consulte también
XtfConsoleControlXBOX Tools Framework