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

# 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](https://docs.xbox.com/zh-TW/reference/system/dstorage/enums/dstorage_bcpack_mode.md) : 4

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

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

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

*DestinationIsPhysicalPages*\
類型：UINT64 : 1

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

*SourceType*\
類型：[DSTORAGE\_REQUEST\_SOURCE\_TYPE](https://docs.xbox.com/zh-TW/reference/system/dstorage/enums/dstorage_request_source_type.md)

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

*SourceIsPhysicalPages*\
類型：UINT64

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

*Reserved*\
類型：UINT64 : 40

保留。必須為零。

*AsUINT64*\
類型：UINT64

此結構的 UINT64 表示法。

## 備註

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

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

## 需求

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

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

## 另請參閱

[DStorage](https://docs.xbox.com/zh-TW/reference/system/dstorage/dstorage_members.md)


## Related topics

- [DSTORAGE_SWIZZLE_MODE](https://docs.xbox.com/zh-TW/reference/system/dstorage/enums/dstorage_swizzle_mode.md)
- [DSTORAGE_BCPACK_MODE](https://docs.xbox.com/zh-TW/reference/system/dstorage/enums/dstorage_bcpack_mode.md)
- [DSTORAGE_REQUEST_SOURCE_TYPE](https://docs.xbox.com/zh-TW/reference/system/dstorage/enums/dstorage_request_source_type.md)
- [DStorage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_REQUEST](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request.md)