Bagikan melalui

DSTORAGE_REQUEST_OPTIONS

  • Artikel

Options for a DirectStorage read request.

Syntax

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
Type: UINT64 : 1

Boolean value indicating whether to perform RFC 1950 decompression.

BcpackMode
Type: DSTORAGE_BCPACK_MODE : 4

DSTORAGE_BCPACK_MODE value indicating the type of BCPack decompression to perform.

SwizzleMode
Type: DSTORAGE_SWIZZLE_MODE : 16

DSTORAGE_SWIZZLE_MODE value indicating the type of swizzle operation to perform.

DestinationIsPhysicalPages
Type: UINT64 : 1

Boolean value indicating that destination memory is an array of physical pages allocated through XMemAllocatePhysicalPages (NDA topic).

SourceType
Type: DSTORAGE_REQUEST_SOURCE_TYPE

DSTORAGE_REQUEST_SOURCE_TYPE value indicating whether the source of the request is a file or a block of memory.

SourceIsPhysicalPages
Type: UINT64

When SourceType is DSTORAGE_REQUEST_SOURCE_MEMORY, this Boolean value indicates that source memory is an array of physical pages allocated through XMemAllocatePhysicalPages (NDA topic).

Reserved
Type: UINT64 : 40

Reserved. Must be zero.

AsUINT64
Type: UINT64

UINT64 representation of the structure.

Remarks

This structure is used in the DSTORAGE_REQUEST and DSTORAGE_ERROR_RECORD structures. The structure can be reused as soon as IDStorageQueueX::EnqueueRequest returns.

For more information about read requests, see the "EnqueueRequest" section of DirectStorage Overview.

Requirements

Header: dstorage_xs.h

Supported platforms: Xbox Series consoles

See also

DStorage