> ## 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.

# XPersistentLocalStorageSpaceInfo

> XPersistentLocalStorageSpaceInfo

# XPersistentLocalStorageSpaceInfo

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

<a id="syntaxSection" />

## 語法

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

<a id="membersSection" />

### 成員

*availableFreeBytes*\
類型：uint64\_t

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

*totalFreeBytes*\
類型：uint64\_t

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

*usedBytes*\
類型：uint64\_t

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

*totalBytes*\
類型：uint64\_t

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

<a id="remarksSection" />

## 備註

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

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

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

<a id="requirementsSection" />

## 需求

**標頭：** XPersistentLocalStorage.h

**程式庫：** xgameruntime.lib

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

<a id="seealsoSection" />

## 另請參閱

[XPersistentLocalStorage](/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)\
[XPersistentLocalStorageGetSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo)\
[XPersistentLocalStoragePromptUserForSpaceAsync](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync)。


## Related topics

- [XPersistentLocalStorageGetSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStorage](/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [本機儲存空間](/zh-TW/build/console-features/storage/local-storage.md)