Skip to main content

DSTORAGE_ERROR_RECORD

失败的 DirectStorage 请求的详细记录。

Syntax

Members

FailureCount
类型:UINT32
自上一次调用 RetrieveErrorRecord 以来队列中失败请求的数量。 HResult
类型:HRESULT
失败的 HRESULT 代码。 CommandType
类型:DSTORAGE_COMMAND_TYPE
导致失败的入队请求类型。 Options
类型:DSTORAGE_REQUEST_OPTIONS
失败请求的各种选项。 Destination
类型:void *
用于接收失败请求最终结果的缓冲区地址。 DestinationSize
类型:UINT32
失败请求最终结果的预期大小(以字节为单位),此值由初始请求的一部分传入。 Filename
类型:WCHAR[MAX_PATH]
请求所针对文件的名称。 FileOffset
类型:UINT64
失败读取请求起始位置在文件中的偏移量(以字节为单位)。 *Source
类型:void
对于以内存为源的请求,指向要读取的缓冲区地址。 SourceSize
类型:UINT32
要从源读取的字节数。 CancellationTag
类型:UINT64
用于取消匹配的任意 UINT64 数值。 Name
类型:CHAR[DSTORAGE_REQUEST_MAX_NAME]
请求的名称。 *StatusArray
类型:IDStorageStatusArrayX
对于状态写入请求,指向 IDStorageStatusArrayX 对象。 Index
类型:UINT32
对于状态写入请求,IDStorageStatusArrayX 对象中用于接收状态的状态条目索引。 *Fence
类型:ID3D12Fence
对于 fence 写入请求,指向 ID3D12Fence 对象。 Value
类型:UINT64
对于 fence 写入请求,要写入 fence 的值。

Remarks

此结构由 IDStorageQueueX::RetrieveErrorRecord 方法使用。 如果 CommandTypeDSTORAGE_COMMAND_TYPE_NONE,则其余数据未定义。 有关详细信息,请参阅 DirectStorage 概述 中的“GetErrorEvent/RetrieveErrorRecord”一节。

Requirements

头文件: dstorage_xs.h 受支持的平台: XBOX Series 主机

See also

DStorage
最后修改于 2026年8月24日