> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGameSaveFilesUiProgressGetProgress

> 获取同步操作的当前进度。可在 PFGameSaveFilesUiProgressCallback 内调用此函数，或在同步进行期间定期轮询，以获取最新的字节级进度。在 PreparingForUpload 期间，current/total 表示已处理/预期的未压缩字节数。在 Uploading 期间，current/total 表示已传输/预期的未压缩字节数。在 Downloading 期间，current/total 表示已下载/预期的字节数。如果 total 为 0，则表示总大小尚未确定，游戏应将其视为不确定进度（例如，显示旋转图标），而不是除以零或显示 0%。

获取同步操作的当前进度。可在 PFGameSaveFilesUiProgressCallback 内调用此函数，或在同步进行期间定期轮询，以获取最新的字节级进度。在 PreparingForUpload 期间，current/total 表示已处理/预期的未压缩字节数。在 Uploading 期间，current/total 表示已传输/预期的未压缩字节数。在 Downloading 期间，current/total 表示已下载/预期的字节数。如果 total 为 0，则表示总大小尚未确定，游戏应将其视为不确定进度（例如，显示旋转图标），而不是除以零或显示 0%。

## 语法

```cpp theme={null}
HRESULT PFGameSaveFilesUiProgressGetProgress(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesSyncState* syncState,  
    uint64_t* current,  
    uint64_t* total  
)  
```

### 参数

**`localUserHandle`**   PFLocalUserHandle

本地用户句柄。

**`syncState`**   [PFGameSaveFilesSyncState\*](/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilessyncstate)<br />*可选输出*

操作的同步状态。

**`current`**   uint64\_t\*<br />*可选输出*

当前活动状态下已处理的字节数。

**`total`**   uint64\_t\*<br />*可选输出*

当前活动状态下预期的总字节数。

### 返回值

类型：HRESULT

TBD

## 要求

**头文件：** PFGameSaveFilesUi.h

## 另请参阅

[PFGameSaveFilesUi 成员](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members)


## Related topics

- [PFGameSaveFilesUiProgressCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md)
- [Game Saves UI 回调](/zh-CN/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [服务 C API 概览 - PFGameSaveFilesUi.h](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveFilesUiProgressUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)
- [PFGameSaveFilesSetUiProgressResponse](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md)