Skip to main content

DSTORAGE_ERROR_RECORD

失敗した DirectStorage 要求の詳細なレコード。

構文

メンバー

FailureCount
Type: UINT32
前回の RetrieveErrorRecord 呼び出し以降にキュー内で失敗した要求の数。 HResult
Type: HRESULT
失敗の HRESULT コード。 CommandType
Type: DSTORAGE_COMMAND_TYPE
失敗の原因となったエンキュー要求のタイプ。 Options
Type: DSTORAGE_REQUEST_OPTIONS
失敗した要求のさまざまなオプション。 Destination
Type: void *
失敗した要求の最終結果を受け取るバッファーのアドレス。 DestinationSize
Type: UINT32
失敗した要求の最終結果の期待サイズ (バイト単位)。最初の要求の一部として渡されたもの。 Filename
Type: WCHAR[MAX_PATH]
要求が対象としたファイルの名前。 FileOffset
Type: UINT64
失敗した読み取り要求の開始位置までの、ファイル内のオフセット (バイト単位)。 *Source
Type: void
メモリ ソース要求の場合、読み取り元のバッファーのアドレス。 SourceSize
Type: UINT32
ソースから読み取るバイト数。 CancellationTag
Type: UINT64
キャンセル マッチングに使用される任意の UINT64 番号。 Name
Type: CHAR[DSTORAGE_REQUEST_MAX_NAME]
要求の名前。 *StatusArray
Type: IDStorageStatusArrayX
ステータス書き込み要求の場合、IDStorageStatusArrayX オブジェクト。 Index
Type: UINT32
ステータス書き込み要求の場合、ステータスを受け取る IDStorageStatusArrayX オブジェクト内のステータス エントリのインデックス。 *Fence
Type: ID3D12Fence
フェンス書き込み要求の場合、ID3D12Fence オブジェクト。 Value
Type: UINT64
フェンス書き込み要求の場合、フェンスに書き込む値。

解説

この構造体は、IDStorageQueueX::RetrieveErrorRecord メソッドで使用されます。 CommandTypeDSTORAGE_COMMAND_TYPE_NONE の場合、残りのデータは未定義です。 詳細については、DirectStorage の概要 の「GetErrorEvent/RetrieveErrorRecord」セクションを参照してください。

要件

ヘッダー: dstorage_xs.h サポートされているプラットフォーム: XBOX Series 本体

関連項目

DStorage
最終更新日 2026年8月24日