Skip to main content

DSTORAGE_ERROR_RECORD

失敗之 DirectStorage 要求的詳細記錄。

語法

成員

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
對於柵欄寫入要求,這是 ID3D12Fence 物件。 Value
類型:UINT64
對於柵欄寫入要求,這是要寫入柵欄的值。

備註

此結構由 IDStorageQueueX::RetrieveErrorRecord 方法使用。 如果 CommandType 為 DSTORAGE_COMMAND_TYPE_NONE,其餘資料都是未定義的。 如需詳細資訊,請參閱 DirectStorage 概觀中的「GetErrorEvent/RetrieveErrorRecord」章節。

需求

標頭: dstorage_xs.h 支援的平台: XBOX Series 主機

另請參閱

DStorage
Last modified on October 6, 2026