Skip to main content
タイル化リソースがタイルにどのように分割されるかについての情報を取得します。

構文

パラメーター

pTiledResource [in]
型: ID3D12Resource *
情報を取得するタイル化 ID3D12Resource を指定します。 pNumTilesForEntireResource [out, optional]
型: UINT *
タイル化リソース全体を格納するために必要なタイル数を受け取る変数へのポインター。 pPackedMipDesc [out, optional]
型: D3D12_PACKED_MIP_INFO *
タイル化リソースのミップマップがどのようにパックされているかについての情報を GetResourceTiling が入力する D3D12_PACKED_MIP_INFO 構造体へのポインター。 pStandardTileShapeForNonPackedMips [out, optional]
型: D3D12_TILE_SHAPE *
タイル形状に関する情報を GetResourceTiling が入力する D3D12_TILE_SHAPE 構造体を指定します。これは、パックされたミップマップを含まない、タイル化リソースのディメンションとは無関係な、タイル内にピクセルがどのように収まるかについての情報です。タイル化リソース全体がパックされている場合、タイル化リソースはパックされたミップマップに対して定義されたレイアウトを持たないため、このパラメーターは意味を持ちません。この場合、GetResourceTiling は D3D12_TILE_SHAPE のメンバーをゼロに設定します。 pNumSubresourceTilings [in, out, optional]
型: UINT *
サブリソース内のタイル数を含む変数へのポインター。入力時、これはタイリングを照会するサブリソースの数です。出力時、これは pSubresourceTilingsForNonPackedMips で実際に取得された数 (使用可能な数にクランプされる) です。 FirstSubresourceTilingToGet [in]
型: UINT
取得する最初のサブリソース タイルの番号。pNumSubresourceTilings が指す数値が 0 の場合、GetResourceTiling はこのパラメーターを無視します。 pSubresourceTilingsForNonPackedMips [out]
型: D3D12_SUBRESOURCE_TILING *
サブリソース タイルに関する情報を GetResourceTiling が入力する D3D12_SUBRESOURCE_TILING 構造体を指定します。サブリソース タイルがパックされたミップマップの一部である場合、GetResourceTilingStartTileIndexInOverallResource メンバーを除く D3D12_SUBRESOURCE_TILING のメンバーをゼロに設定し、StartTileIndexInOverallResource メンバーは D3D12_PACKED_TILE (0xffffffff) に設定します。D3D12_PACKED_TILE 定数は、この状況では D3D12_SUBRESOURCE_TILING 構造体全体が意味を持たず、pPackedMipDesc パラメーターが指す情報が適用されることを示します。

戻り値

型: void なし。

解説

ヒープ サイズを計算し CreatePlacedResource を呼び出す際に必要となるテクスチャの合計リソース サイズを見積もるには、GetResourceTiling ではなく GetResourceAllocationInfo を使用します。 GetResourceTiling はこの用途には使用できません。 タイル化リソースの詳細については、ボリューム タイル リソース を参照してください。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされているプラットフォーム: XBOX Series 本体および XBOX One ファミリ

関連項目

ID3D12Device サブリソース
最終更新日 2026年8月24日