> ## 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 读取请求的选项。

## Syntax

```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;
};
```

### Members

*ZlibDecompress*\
类型：UINT64 : 1

指示是否执行 RFC 1950 解压缩的布尔值。

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

指示要执行的 BCPack 解压缩类型的 `DSTORAGE_BCPACK_MODE` 值。

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

指示要执行的调配（swizzle）操作类型的 `DSTORAGE_SWIZZLE_MODE` 值。

*DestinationIsPhysicalPages*\
类型：UINT64 : 1

指示目标内存是通过 [XMemAllocatePhysicalPages（NDA 主题）](/reference/system/xmem/functions/xmemallocatephysicalpages) 分配的物理页数组的布尔值。

*SourceType*\
类型：[DSTORAGE\_REQUEST\_SOURCE\_TYPE](/reference/system/dstorage/enums/dstorage_request_source_type)

指示请求的源是文件还是一块内存的 `DSTORAGE_REQUEST_SOURCE_TYPE` 值。

*SourceIsPhysicalPages*\
类型：UINT64

当 *SourceType* 为 `DSTORAGE_REQUEST_SOURCE_MEMORY` 时，此布尔值指示源内存是通过 [XMemAllocatePhysicalPages（NDA 主题）](/reference/system/xmem/functions/xmemallocatephysicalpages) 分配的物理页数组。

*Reserved*\
类型：UINT64 : 40

保留。必须为零。

*AsUINT64*\
类型：UINT64

结构的 UINT64 表示形式。

## Remarks

此结构用于 [DSTORAGE\_REQUEST](/reference/system/dstorage/structs/dstorage_request) 和 [DSTORAGE\_ERROR\_RECORD](/reference/system/dstorage/structs/dstorage_error_record) 结构。[IDStorageQueueX::EnqueueRequest](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuerequest) 返回后即可重用该结构。

有关读取请求的详细信息，请参阅 [DirectStorage 概述](/build/console-features/storage/directstorage/directstorage-overview) 中的“EnqueueRequest”一节。

## Requirements

**头文件：** dstorage\_xs.h

**受支持的平台：** XBOX Series 主机

## See also

[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_SWIZZLE_MODE](/zh-CN/reference/system/dstorage/enums/dstorage_swizzle_mode.md)
- [DSTORAGE_REQUEST_SOURCE_TYPE](/zh-CN/reference/system/dstorage/enums/dstorage_request_source_type.md)
- [DSTORAGE_BCPACK_MODE](/zh-CN/reference/system/dstorage/enums/dstorage_bcpack_mode.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_REQUEST](/zh-CN/reference/system/dstorage/structs/dstorage_request.md)