IXtfDeployCallback::OnDeployFileProgress
콘솔에 파일을 배포할 때 진행률을 보고하기 위해 호출된 콜백입니다.
구문
public:
HRESULT OnDeployFileProgress(
LPCWSTR pszFilePath,
ULONGLONG ullBytesTransferred,
ULONGLONG ullFileSize
)
매개 변수
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 콘솔 도구용)