Skip to main content

IXtfCopyFileCallback::OnFileCopyProgress Method

在文件复制进度发生变化时调用。

语法

参数

pszSrcFileName
类型:LPCWSTR
指向源文件的文件名的指针。此参数已弃用,其值现在是 pszDstFileName 的副本。 pszDstFileName
类型:LPCWSTR
指向目标文件的文件名的指针。 ullFileSize
类型:ULONGLONG
源文件的总大小(以字节为单位)。 ullBytesCopied
类型:ULONGLONG
文件中已复制的字节数。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则返回 HRESULT 错误代码。

备注

此函数在文件复制操作期间由 IXtfFileIOClient::CopyFiles 方法针对传输的每个数据包调用。对某个文件的 IXtfCopyFileCallback::OnFileCopyProgress 的初始调用中,ullBytesCopied 指定为 0 字节,ullFileSize 指定为 MAX_FILE_SIZE 字节。此初始调用表示已开始复制新文件。然后,你可以使用后续 IXtfCopyFileCallback::OnFileCopyProgress 调用中指定的文件信息来跟踪和显示文件复制操作期间的进度。如果此回调函数返回 HRESULT 错误代码,则文件复制操作将中止。

要求

头文件: xtffileio.h 库: xtffileio.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

IXtfCopyFileCallback Interface
XtfFileIO
最后修改于 2026年8月24日