DSTORAGE_ERROR_RECORD
Detailed record of a failed DirectStorage request.Syntax
Members
FailureCountType: UINT32 The number of failed requests in the queue since the last
RetrieveErrorRecord call.
HResultType: HRESULT The HRESULT code of the failure. CommandType
Type: DSTORAGE_COMMAND_TYPE Type of the enqueue request that caused the failure. Options
Type: DSTORAGE_REQUEST_OPTIONS Various options of the failed request. Destination
Type: void * Address of the buffer to receive the final result of the failed request. DestinationSize
Type: UINT32 Expected size, in bytes, of the final result of the failed request, as passed in as part of the initial request. Filename
Type: WCHAR[MAX_PATH] The name of the file that the request targeted. FileOffset
Type: UINT64 The offset, in bytes, in the file to the start of the failed read request. *Source
Type: void For a memory-sourced request, the address of the buffer to read from. SourceSize
Type: UINT32 The number of bytes to read from the source. CancellationTag
Type: UINT64 An arbitrary UINT64 number used for cancallation matching. Name
Type: CHAR[DSTORAGE_REQUEST_MAX_NAME] Name of the request. *StatusArray
Type: IDStorageStatusArrayX For a status write request, the IDStorageStatusArrayX object. Index
Type: UINT32 For a status write request, the index of the status entry in the
IDStorageStatusArrayX object to receive the status.
*FenceType: ID3D12Fence For a fence write request, the
ID3D12Fence object.
ValueType: UINT64 For a fence write request, the value to write to the fence.
Remarks
This structure is used by the IDStorageQueueX::RetrieveErrorRecord method. If CommandType isDSTORAGE_COMMAND_TYPE_NONE, the remaining data is undefined.
For more information, see the “GetErrorEvent/RetrieveErrorRecord” section in DirectStorage Overview.
