IXtfApplicationClient::DebugEnable
지정된 패키지 모니커의 앱 패키지에 대한 디버깅을 활성화하거나 비활성화합니다.구문
매개 변수
pszPackageMoniker형식: LPCWSTR 앱의 패키지 모니커에 대한 포인터입니다. fEnable
형식: BOOL 디버깅을 활성화하려면 TRUE를 지정하고, 비활성화하려면 FALSE를 지정합니다.
반환값
형식: HRESULT 성공하면S_OK를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드는 XBOX One Software Development Kit\ERA 타이틀에만 적용됩니다. 이 메서드를 호출해도 Microsoft Game Development Kit(GDK) 타이틀에는 영향을 미치지 않습니다.
pszPackageMoniker에 지정된 패키지 모니커의 앱 패키지에 대한 디버깅을 활성화하거나 비활성화하며, 해당 패키지의 디버그 플래그를 각각 설정하거나 지웁니다.
패키지가 실행 중이지 않을 때만 해당 패키지의 디버그 플래그를 설정해야 합니다. 실행 중인 패키지에 디버그 플래그를 설정하면 예측할 수 없는 결과가 발생할 수 있습니다.
- 활성화를 완료하는 데 45초 이상 걸려도 앱이 종료되지 않습니다.
- 일시 중단하는 데 너무 오래 걸려도 앱이 종료되지 않습니다. 제한은 독점 앱의 경우 1초, 공유 앱의 경우 5초입니다.
- 표시 상태를 너무 오래 상실해도 앱이 일시 중단되지 않습니다. 제한은 독점 앱의 경우 10분, 공유 앱의 경우 5초입니다.
- 앱을 일시 중단하려면 xbapp suspend (NDA topic) 명령을 호출하거나 IXtfApplicationClient::Suspend 함수를 호출하세요.
- 앱이 디버그 모드에 있을 때는 일반 PLM(Process Lifetime Management) 제한이 적용되지 않으며, XBOX Tools Framework(XTF) 도구를 사용하여 지시할 때만 일시 중단되거나 다시 시작됩니다.
디버그 모드에서는 표시 상태와 같은 일반 PLM 프로세스가 일시 중단을 유발하지 않는 상태에서도 앱이 일시 중단될 수 있습니다. 디버그 모드에서 앱을 실행하는 동안 일시 중단 및 다시 시작 동작을 테스트할 때는 일반 동작을 테스트하는 것인지 아니면 디버그 모드로 실행하는 것의 효과인지 확인하기 위해 주의해야 합니다.
- 활성화를 완료하는 데 45초 이상 걸리면 앱이 종료됩니다.
- 일시 중단하는 데 너무 오래 걸리면 앱이 종료됩니다. 제한은 독점 앱의 경우 1초, 공유 앱의 경우 5초입니다.
- 표시 상태를 너무 오래 상실하면 앱이 일시 중단됩니다. 제한은 독점 앱의 경우 10분, 공유 앱의 경우 5초입니다.
- Visual Studio 디버거가 그 시점에 연결되어 있지 않은 한, 앱이 크래시되는 경우.
- 일시 중단 및 다시 시작 작업을 거치는 경우.
- Visual Studio 디버거가 그 시점에 연결되어 있지 않은 한, 종료를 거치는 경우.
요구 사항
헤더: xtfapplication.h 라이브러리: xtfapplication.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)참고 항목
IXtfApplicationClientXtfApplication