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

# DSTORAGE_REQUEST_OPTIONS

> DSTORAGE_REQUEST_OPTIONS

# DSTORAGE\_REQUEST\_OPTIONS

DirectStorage 讀取要求的選項。

## 語法

```cpp theme={null}
union DSTORAGE_REQUEST_OPTIONS {
    struct {
        UINT64 ZlibDecompress : 1;
        DSTORAGE_BCPACK_MODE BcpackMode : 4;  
        DSTORAGE_SWIZZLE_MODE SwizzleMode : 16;  
        UINT64 DestinationIsPhysicalPages : 1;  
        DSTORAGE_REQUEST_SOURCE_TYPE SourceType : 1;  
        UINT64 SourceIsPhysicalPages : 1;  
        UINT64 Reserved : 40;  
    };
    UINT64 AsUINT64;
};
```

### 成員

*ZlibDecompress*\
類型：UINT64 : 1

布林值，指出是否要執行 RFC 1950 解壓縮。

*BcpackMode*\
類型：[DSTORAGE\_BCPACK\_MODE](/zh-TW/reference/system/dstorage/enums/dstorage_bcpack_mode) : 4

`DSTORAGE_BCPACK_MODE` 值，指出要執行的 BCPack 解壓縮類型。

*SwizzleMode*\
類型：[DSTORAGE\_SWIZZLE\_MODE](/zh-TW/reference/system/dstorage/enums/dstorage_swizzle_mode) : 16

`DSTORAGE_SWIZZLE_MODE` 值，指出要執行的 swizzle 作業類型。

*DestinationIsPhysicalPages*\
類型：UINT64 : 1

布林值，指出目的地記憶體是透過 [XMemAllocatePhysicalPages (NDA 主題)](/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages) 配置的實體頁面陣列。

*SourceType*\
類型：[DSTORAGE\_REQUEST\_SOURCE\_TYPE](/zh-TW/reference/system/dstorage/enums/dstorage_request_source_type)

`DSTORAGE_REQUEST_SOURCE_TYPE` 值，指出要求的來源是檔案還是記憶體區塊。

*SourceIsPhysicalPages*\
類型：UINT64

當 *SourceType* 為 `DSTORAGE_REQUEST_SOURCE_MEMORY` 時，此布林值指出來源記憶體是透過 [XMemAllocatePhysicalPages (NDA 主題)](/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages) 配置的實體頁面陣列。

*Reserved*\
類型：UINT64 : 40

保留。必須為零。

*AsUINT64*\
類型：UINT64

此結構的 UINT64 表示法。

## 備註

此結構用於 [DSTORAGE\_REQUEST](/zh-TW/reference/system/dstorage/structs/dstorage_request) 和 [DSTORAGE\_ERROR\_RECORD](/zh-TW/reference/system/dstorage/structs/dstorage_error_record) 結構中。一旦 [IDStorageQueueX::EnqueueRequest](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuerequest) 傳回，就可以重複使用此結構。

如需讀取要求的詳細資訊，請參閱 [DirectStorage 概觀](/zh-TW/build/console-features/storage/directstorage/directstorage-overview)的「EnqueueRequest」章節。

## 需求

**標頭：** dstorage\_xs.h

**支援的平台：** XBOX Series 主機

## 另請參閱

[DStorage](/zh-TW/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_REQUEST_OPTIONS](/reference/system/dstorage/structs/dstorage_request_options.md)
- [DStorage](/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_REQUEST_SOURCE_TYPE](/reference/system/dstorage/enums/dstorage_request_source_type.md)
- [DSTORAGE_SWIZZLE_MODE](/reference/system/dstorage/enums/dstorage_swizzle_mode.md)