IXtfDeployCallback::OnDeployFileProgress
콘솔로 파일을 배포하는 진행 상황을 보고하기 위해 호출되는 콜백입니다.구문
매개 변수
pszFilePath형식: LPCWSTR 배포 중인 파일의 경로입니다. ullBytesTransferred
형식: ULONGLONG 지금까지 전송된 바이트 수입니다. ullFileSize
형식: ULONGLONG 전송 중인 파일의 총 크기(바이트)입니다.
반환 값
형식: HRESULT 배포를 계속하려면S_OK를 반환하거나, 배포를 취소하려면 HRESULT 오류 코드를 반환합니다.
설명
이 콜백은 배포 시스템이 배포 중인 PC에서 콘솔로 파일을 전송할 때 호출됩니다. 이 콜백은 파일별로 버퍼 블록이 성공적으로 전송될 때마다 한 번씩 호출됩니다. 이 콜백은 성공적으로 전송된 각 파일에 대해 항상 최소 두 번 호출됩니다. 배포 시작 시 한 번, 배포 종료 시 한 번 호출됩니다. 길이가 0인 파일이 배포되는 경우 두 호출 모두 0바이트 중 0바이트가 전송되었음을 보고합니다. 배포 프로세스 중에 파일을 평가하는 방식과 콜백이 호출되는 시점에 대한 자세한 내용은 IXtfDeployCallback 인터페이스를 참조하세요.배포용 파일 전송 프로세스는 여러 스레드를 사용합니다. 코드에서는
pszFilePath로 진행률 메시지를 상관시키고 일반적인 다중 스레딩 문제로부터 보호해야 합니다.IXtfDeployCallback의 다른 콜백과 마찬가지로 이 콜백이 S_OK를 반환하면 배포 프로세스가 계속됩니다. 이 콜백이 HRESULT 오류 코드를 반환하면 배포 프로세스가 즉시 취소됩니다. 이미 전송되거나 삭제된 파일은 그대로 유지되며, 부분적으로 전송된 파일은 잘린 형태로 닫힙니다. 콘솔의 모든 파일이 완전하고 최신 상태인지 확인하려면 다른 배포를 완료해야 합니다.
요구 사항
헤더: xtfapplication.h 라이브러리: xtfapplication.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)함께 보기
IXtfDeployCallback 인터페이스XtfApplication