Skip to main content

IXtfCopyFileCallback::OnStartFileCopy Method

在开发主机上的两个位置之间的文件复制开始时调用。

语法

参数

pszRootDirectory
类型:LPCWSTR
指向复制的根目录路径的指针。 pszSearchPattern
类型:LPCWSTR
指向搜索模式的指针,该模式定义要复制的源文件的文件名。此参数接受通配符,以匹配符合指定模式的字符串。 pSrcFileInfo
类型:LPCXTFFILEINFO
指向 XTFFILEINFO 结构的指针,该结构包含有关所复制文件的信息。 pszDstFileName
类型:LPCWSTR
指向目标文件的文件名的指针。

返回值

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

备注

此回调函数在文件复制操作开始时由 IXtfFileIOClient::CopyFiles 方法调用一次。XTFFILEINFO 结构中返回的文件大小表示需要复制的文件的总大小(以字节为单位)。可以使用此总和来跟踪文件复制操作的总体进度。如果此回调函数返回 HRESULT 错误代码,则文件复制操作将中止。

要求

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

另请参阅

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