Skip to main content

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 콘솔 도구용)

함께 보기

XtfConsoleControl
XBOX Tools Framework
마지막 수정일 2026년 8월 24일