DSTORAGE_REQUEST_OPTIONS

DirectStorage 读取请求的选项。

语法

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 : 4

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

SwizzleMode
类型：DSTORAGE_SWIZZLE_MODE : 16

指示要执行的重排操作类型的 DSTORAGE_SWIZZLE_MODE 值。

DestinationIsPhysicalPages
类型：UINT64 : 1

布尔值，指示目标内存是通过 XMemAllocatePhysicalPages（NDA 主题）要求授权分配的物理页面数组。

SourceType
类型：DSTORAGE_REQUEST_SOURCE_TYPE

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

SourceIsPhysicalPages
类型：UINT64

如果 SourceType 为 DSTORAGE_REQUEST_SOURCE_MEMORY，则此布尔值指示源内存是通过 XMemAllocatePhysicalPages（NDA 主题）要求授权分配的物理页面数组。

Reserved
类型：UINT64 : 40

保留。 必须为零。

AsUINT64
类型：UINT64

结构的 UINT64 表示。

备注

此结构用于 DSTORAGE_REQUEST 和 DSTORAGE_ERROR_RECORD 结构。 IDStorageQueueX::EnqueueRequest 返回后，可立即重用该结构。

有关读取请求的详细信息，请参阅 DirectStorage 概述的“EnqueueRequest”部分。

要求

头文件：dstorage_xs.h

支持的平台：Xbox Series 主机

另请参阅

DStorage