다음을 통해 공유

XtfCaptureOutputBegin

  • 아티클

디버그 출력 캡처를 시작합니다.

구문

void XtfCaptureOutputBegin(
         PCWSTR address,
         XtfDebugStringCallback debugStringCallback,
         XtfDebugStringErrorCallback debugStringErrorCallback,
         PVOID context,
         PHANDLE hListen
)

매개 변수

address
형식: PCWSTR

[in] 콘솔의 도구 IP 주소입니다.

debugStringCallback
Type: XtfDebugStringCallback

[in, optional] 각 출력 디버그 문자열에 대해 호출되는 선택적 콜백입니다.

debugStringErrorCallback
Type: XtfDebugStringErrorCallback

[in, optional] 발생한 각 오류에 대해 호출되는 선택적 콜백입니다.

context
형식: PVOID

[in, optional] 콜백 함수에 전달된 개체에 대한 포인터입니다. 이 개체를 활용하면 각 콜백 호출을 이 캡처 세션에 연결할 수 있습니다.

hListen
형식: PHANDLE

[out] 이 캡처 세션을 나타내는 핸들입니다.

반환 값

없음.

설명

이 함수와 XtfCaptureOutputBegin 함수를 사용하여 개발 콘솔의 일반적인 디버그 출력 캡처를 시작하고 중지합니다. 개발 콘솔에서 특정 프로세스 ID의 디버그 출력을 모니터링하려면 디버그 모니터 클라이언트를 사용합니다. 디버그 모니터 클라이언트 사용에 대한 자세한 내용은 XtfCreateDebugMonitorClient를 참조하세요.

캡처 세션에 대한 디버그 문자열을 캡처하려면 debugStringCallback에서 XtfDebugStringCallback 함수를 구현하고 지정해야 합니다. 마찬가지로 캡처 세션 중에 발생한 오류를 캡처하려면 debugStringErrorCallback에서 XtfDebugStringErrorCallback 함수를 구현하고 지정해야 합니다. 하지만 콜백 함수는 필요하지 않습니다.

디버그 출력 캡처를 중지하고 캡처 세션에 연결된 리소스를 해제하려면 XtfCaptureOutputEnd(을)를 호출하고 그 캡처 세션에 대해 hListen에서 반환되는 핸들을 지정합니다.

참고 항목

캡처 세션을 중지하려면 XtfCaptureOutputEnd(을)를 호출해야 합니다. 그렇지 않으면 캡처 세션은 분리된 개체가 되고 캡처 세션과 연결된 리소스가 해제되지 않아 메모리 누수가 발생합니다.

요건

헤더: xtfapi.h

라이브러리: XtfApi.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

IXtfDebugMonitorClient 인터페이스
XTF 전송 오류(NDA 항목)
추가 Xtf API