Skip to main content

DSTORAGE_REQUEST

DirectStorage の読み取り要求を表します。

構文

メンバー

Options
Type: DSTORAGE_REQUEST_OPTIONS
この要求のさまざまなオプション。 Destination
Type: void *
この要求の最終結果を受け取るバッファーのアドレス。 DestinationPageArray
Type: PULONG_PTR
DestinationIsPhysicalPages が指定されている場合に、この要求の最終結果を受け取るページ配列のアドレス。各エントリは 64 KB のページ番号です。 DestinationPageOffset
Type: UINT16
DestinationIsPhysicalPages が指定されている場合、宛先が開始する 64 KB ページ内のオフセット。 DestinationSize
Type: UINT32
この要求の最終結果の期待サイズ (バイト単位)。要求に展開が含まれない場合、これは SourceSize に等しくなります。展開を含む要求の場合、この値は SourceSize より大きくなります。 File
Type: IDStorageFileX *
SourceTypeDSTORAGE_REQUEST_SOURCE_FILE の場合、この読み取り要求を実行するファイル。 FileOffset
Type: UINT64
SourceTypeDSTORAGE_REQUEST_SOURCE_FILE の場合、読み取り要求を開始するファイル内のオフセット (バイト単位)。ZlibDecompress または BcpackMode が指定されている場合、オフセットは 16 バイト境界にアラインされている必要があります。 *Source
Type: void
SourceTypeDSTORAGE_REQUEST_SOURCE_MEMORY で、SourceIsPhysicalPages が指定されていない場合、読み取り元のソース バッファーのアドレス。 SourcePageArray
Type: PULONG_PTR
SourceTypeDSTORAGE_REQUEST_SOURCE_MEMORY で、SourceIsPhysicalPages が指定されている場合に、読み取り元のソース バッファーを提供するページ配列のアドレス。各エントリは 64 KB のページ番号です。 SourcePageOffset
Type: UINT16
SourceTypeDSTORAGE_REQUEST_SOURCE_MEMORY で、SourceIsPhysicalPages が指定されている場合、ソースが開始する 64 KB ページ内のオフセット。 SourceSize
Type: UINT32
ファイルまたはメモリ ソースから読み取るサイズ (バイト単位)。 IntermediateSize
Type: UINT32
ZlibDecompressBcpackMode が両方指定されている場合の BCPack 圧縮データのバイト数。 CancellationTag
Type: UINT64
キャンセル マッチングに使用される任意の UINT64 番号。 *Name
Type: const CHAR
要求の名前 (省略可能)。デバッグに使用されます。指定する場合、文字列は要求が完了するまでアクセス可能である必要があります。

解説

この構造体は、 IDStorageQueueX::EnqueueRequest メソッドで使用されます。この 構造体は、EnqueueRequest が戻ったらすぐに再利用できます。 1 つの要求は、次のサイズ要件のいずれかを満たす必要があります。
  • DestinationSize が 32 MiB (DSTORAGE_MAX_4K_PAGE_DESTINATION_SIZE) 以下である。 または
  • SourceSize (メモリからメモリへの要求の場合のみ) と DestinationSize の合計メモリ使用量が 1 GiB (DSTORAGE_MAX_REQUEST_SIZE) 以下で、 32 MiB より大きいメモリ バッファーは 64 KiB ページまたは 2 MiB ページを使用する必要がある。
詳細については、DirectStorage の概要 の「EnqueueRequest」セクションを参照してください。

要件

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

関連項目

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