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

# XPersistentLocalStorageSpaceInfo

> XPersistentLocalStorageSpaceInfo

# XPersistentLocalStorageSpaceInfo

包含由 [XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md) 傳回之永續性本機儲存體 (PLS) 狀態的詳細資料。

## 語法

```cpp theme={null}
typedef struct XPersistentLocalStorageSpaceInfo {
    uint64_t availableFreeBytes;
    uint64_t totalFreeBytes;
    uint64_t usedBytes;
    uint64_t totalBytes;
} XPersistentLocalStorageSpaceInfo
```

### 成員

*availableFreeBytes*\
類型：uint64\_t

可用的儲存空間量 (以位元組為單位)。

*totalFreeBytes*\
類型：uint64\_t

PLS 配置之後剩餘的空間量。您可能必須提示使用者釋放空間，才能使這些位元組可供使用。如需詳細資訊，請參閱 [XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)。

*usedBytes*\
類型：uint64\_t

目前使用中的儲存空間量 (以位元組為單位)。

*totalBytes*\
類型：uint64\_t

使用者可以使用的儲存空間總量 (以位元組為單位)。

## 備註

如果您的遊戲使用可成長的永續性本機儲存體，則可以呼叫 [XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md) 函式來判斷有多少可用的儲存空間。

當 `XPersistentLocalStorageGetSpaceInfo` 函式呼叫傳回時，請檢查 [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md) 物件以取得儲存體詳細資料。

儲存體詳細資料包括使用中的空間量、遊戲可用的空間量，以及是否應提示使用者釋放空間。

## 需求

**標頭：** XPersistentLocalStorage.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XPersistentLocalStorage](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)\
[XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)\
[XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)。


## Related topics

- [XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStorage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [Xbox 主機上的本機儲存空間](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)