ID3D12Device::GetResourceTiling メソッド (d3d12.h)

  • [アーティクル]

タイル化されたリソースをタイルに分割する方法に関する情報を取得します。

構文

void GetResourceTiling(
  [in]                ID3D12Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D12_PACKED_MIP_INFO    *pPackedMipDesc,
  [out, optional]     D3D12_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D12_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

パラメーター

[in] pTiledResource

種類: ID3D12Resource*

情報を取得するタイル ID3D12Resource を指定します。

[out, optional] pNumTilesForEntireResource

型: UINT*

タイル リソース全体を格納するために必要なタイルの数を受け取る変数へのポインター。

[out, optional] pPackedMipDesc

種類: D3D12_PACKED_MIP_INFO*

GetResourceTiling がタイル化されたリソースのミップマップのパック方法に関する情報を入力するD3D12_PACKED_MIP_INFO構造体へのポインター。

[out, optional] pStandardTileShapeForNonPackedMips

種類: D3D12_TILE_SHAPE*

GetResourceTiling がタイル図形に関する情報を入力するD3D12_TILE_SHAPE構造体を指定します。 これは、タイルリソースのサイズに関係なく、タイル内のピクセルの収まり方に関する情報です。パックされたミップマップは含まれません。 タイルリソース全体がパックされている場合、タイル化されたリソースにはパックされたミップマップのレイアウトが定義されていないため、このパラメーターは意味がありません。 このような状況では、 GetResourceTiling は、D3D12_TILE_SHAPEのメンバーを 0 に設定します。

[in, out, optional] pNumSubresourceTilings

型: UINT*

サブリソース内のタイルの数を含む変数へのポインター。 入力時に、タイリングのクエリを実行するサブリソースの数です。出力時に、これは pSubresourceTilingsForNonPackedMips で実際に取得された数値です (使用可能なものにクランプされます)。

[in] FirstSubresourceTilingToGet

型: UINT

取得する最初のサブリソース タイルの番号。 pNumSubresourceTilings が指す数値が 0 の場合、GetResourceTiling はこのパラメーターを無視します。

[out] pSubresourceTilingsForNonPackedMips

種類: D3D12_SUBRESOURCE_TILING*

GetResourceTiling がサブリソース タイルに関する情報を入力するD3D12_SUBRESOURCE_TILING構造体を指定します。 サブリソース タイルがパックされたミップマップの一部である場合、GetResourceTiling は、GetResourceTiling が D3D12_PACKED_TILE (0xffffffff) に設定する StartTileIndexInOverallResource メンバーを除き、D3D12_SUBRESOURCE_TILINGのメンバーを 0 に設定します。 D3D12_PACKED_TILE定数は、この状況では D3D12_SUBRESOURCE_TILING 構造体全体が無意味であり、 pPackedMipDesc パラメーターが指す情報が適用されることを示します。

戻り値

なし

解説

ヒープ サイズを計算して CreatePlacedResource を呼び出すときに必要なテクスチャの合計リソース サイズを見積もるには、 GetResourceTiling ではなく GetResourceAllocationInfoを使用します。 これには GetResourceTiling を使用できません。

タイル化されたリソースの詳細については、「 ボリューム タイル リソース」を参照してください。

要件

   
対象プラットフォーム Windows
ヘッダー d3d12.h
Library D3d12.lib
[DLL] D3d12.dll

関連項目

ID3D12Device

サブリソース