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이 타일식 리소스의 mipmap을 압축하는 방법에 대한 정보로 채워진 D3D12_PACKED_MIP_INFO 구조체에 대한 포인터입니다.

[out, optional] pStandardTileShapeForNonPackedMips

형식: D3D12_TILE_SHAPE*

GetResourceTiling이 타일 셰이프에 대한 정보로 채우는 D3D12_TILE_SHAPE 구조를 지정합니다. 압축된 Mipmap을 포함하지 않고 타일 리소스의 차원과 관계없이 타일에 픽셀이 어떻게 맞는지에 대한 정보입니다. 타일식 리소스 전체가 압축된 경우 타일식 리소스에 압축된 Mipmap에 대해 정의된 레이아웃이 없기 때문에 이 매개 변수는 의미가 없습니다. 이 경우 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 구조를 지정합니다. 하위 리소스 타일이 압축된 mipmap의 일부인 경우 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
라이브러리	D3d12.lib
DLL	D3d12.dll

추가 정보

ID3D12Device

하위 리소스