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

[out, optional] pStandardTileShapeForNonPackedMips

형식: D3D12_TILE_SHAPE*

GetResourceTiling 타일 셰이프에 대한 정보로 채워지도록 D3D12_TILE_SHAPE 구조를 지정합니다. 이것은 압축된 밉맵을 포함하지 않고 타일 리소스의 차원과 관계없이 픽셀이 타일에 어떻게 맞는지에 대한 정보입니다. 타일식 리소스 전체가 압축된 경우 타일식 리소스에 압축된 Mipmap에 대해 정의된 레이아웃이 없기 때문에 이 매개 변수는 의미가 없습니다. 이 경우 GetResourceTiling D3D12_TILE_SHAPE 멤버를 0으로 설정합니다.

[in, out, optional] pNumSubresourceTilings

형식: UINT*

하위 리소스의 타일 수를 포함하는 변수에 대한 포인터입니다. 입력에서 타일링을 쿼리할 하위 리소스의 수입니다. 출력 시 이 값은 pSubresourceTilingsForNonPackedMips(사용 가능한 항목으로 고정됨)에서 실제로 검색된 숫자입니다.

[in] FirstSubresourceTilingToGet

형식: UINT

가져올 첫 번째 하위 리소스 타일의 수입니다. GetResourceTiling pNumSubresourceTilings 가리키는 숫자가 0이면 이 매개 변수를 무시합니다.

[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

하위 리소스