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을 반환합니다. 다음 표에서는 각 스택 덤프 유형에서 반환되는 정보를 설명합니다.
XBOX Tools Framework(XTF)와 같은 사용 가능한 도구 및 자동화 API에 대한 자세한 내용은 도구 및 자동화 API(NDA 항목)를 참조하세요.
LPBSTR 포인터 처리
이 함수에서 반환된 LPBSTR 포인터 처리에 대한 자세한 내용은 BSTR에 대한 메모리 할당 및 해제를 참조하세요.요구 사항
헤더: xtfconsolecontrol.h 라이브러리: xtfconsolecontrol.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)함께 보기
XtfConsoleControlXBOX Tools Framework
