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 方法使用。 如果 CommandType 为DSTORAGE_COMMAND_TYPE_NONE,则其余数据未定义。
有关详细信息,请参阅 DirectStorage 概述 中的“GetErrorEvent/RetrieveErrorRecord”一节。
