IXtfDeployCallback::OnDeployFileProgress
用于报告将文件部署到主机的进度的回调。语法
参数
pszFilePath类型:LPCWSTR 正在部署的文件的路径。 ullBytesTransferred
类型:ULONGLONG 到目前为止已传输的字节数。 ullFileSize
类型:ULONGLONG 正在传输的文件的总大小(以字节为单位)。
返回值
类型:HRESULT 返回S_OK 以继续部署,或返回 HRESULT 错误代码以取消部署。
备注
此回调在部署系统将文件从部署 PC 传输到主机时调用。每为一个文件成功传输一个缓冲区块,就会调用此回调一次。每个成功传输的文件至少调用两次此回调:一次在部署开始时,一次在部署结束时。如果部署一个长度为零的文件,两次调用都将报告已传输零个字节(共零个字节)。有关文件如何评估以及在部署过程中何时调用回调的详细信息,请参阅 IXtfDeployCallback Interface。部署的文件传输过程使用多个线程。你的代码必须确保按
pszFilePath 关联进度消息,并防范典型的多线程问题。IXtfDeployCallback 的其他回调一样,如果此回调返回 S_OK,则部署过程继续。如果此回调返回任何 HRESULT 错误代码,则部署过程会立即取消。已传输或删除的文件保持原样,部分传输的文件将以其被截断的形式关闭。必须完成另一次部署,以确保主机上的所有文件完整且为最新。
要求
头文件: xtfapplication.h 库: xtfapplication.lib 支持的平台: Windows(用于 XBOX 主机工具)另请参阅
IXtfDeployCallback InterfaceXtfApplication
