> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetResourceTiling

> 타일 리소스가 타일로 분해되는 방식에 대한 정보를 가져옵니다. (ID3D12Device.GetResourceTiling)

타일 리소스가 타일로 분해되는 방식에 대한 정보를 가져옵니다.

## 구문

```cpp theme={null}
void GetResourceTiling(
    ID3D12Resource  pTiledResource,
    UINT  pNumTilesForEntireResource,
    D3D12_PACKED_MIP_INFO  pPackedMipDesc,
    D3D12_TILE_SHAPE  pStandardTileShapeForNonPackedMips,
    UINT  pNumSubresourceTilings,
    UINT FirstSubresourceTilingToGet,
    D3D12_SUBRESOURCE_TILING  pSubresourceTilingsForNonPackedMips
)
```

### 매개 변수

*pTiledResource \[in]*\
형식: ID3D12Resource \*

정보를 가져올 타일 [ID3D12Resource](/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)를 지정합니다.

*pNumTilesForEntireResource \[out, optional]*\
형식: UINT \*

전체 타일 리소스를 저장하는 데 필요한 타일 수를 받는 변수에 대한 포인터입니다.

*pPackedMipDesc \[out, optional]*\
형식: D3D12\_PACKED\_MIP\_INFO \*

**GetResourceTiling**이 타일 리소스의 밉맵이 패킹된 방식에 대한 정보로 채우는 [D3D12\_PACKED\_MIP\_INFO](/reference/graphics/d3d12/structs/d3d12_packed_mip_info_public) 구조체에 대한 포인터입니다.

*pStandardTileShapeForNonPackedMips \[out, optional]*\
형식: D3D12\_TILE\_SHAPE \*

**GetResourceTiling**이 타일 모양에 대한 정보로 채우는 [D3D12\_TILE\_SHAPE](/reference/graphics/d3d12/structs/d3d12_tile_shape_public) 구조체를 지정합니다. 이는 타일 리소스의 차원과 무관하게 픽셀이 타일에 맞는 방식에 대한 정보이며 패킹된 밉맵은 포함하지 않습니다. 전체 타일 리소스가 패킹된 경우, 타일 리소스는 패킹된 밉맵에 대해 정의된 레이아웃이 없으므로 이 매개 변수는 의미가 없습니다. 이 상황에서 **GetResourceTiling**은 D3D12\_TILE\_SHAPE의 멤버를 0으로 설정합니다.

*pNumSubresourceTilings \[in, out, optional]*\
형식: UINT \*

하위 리소스의 타일 수를 포함하는 변수에 대한 포인터입니다. 입력 시에는 타일링을 쿼리할 하위 리소스의 수이고, 출력 시에는 <i>pSubresourceTilingsForNonPackedMips</i>에서 실제로 검색된 수입니다(사용 가능한 것으로 제한됨).

*FirstSubresourceTilingToGet \[in]*\
형식: UINT

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

*pSubresourceTilingsForNonPackedMips \[out]*\
형식: D3D12\_SUBRESOURCE\_TILING \*

**GetResourceTiling**이 하위 리소스 타일에 대한 정보로 채우는 [D3D12\_SUBRESOURCE\_TILING](/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public) 구조체를 지정합니다. 하위 리소스 타일이 패킹된 밉맵의 일부인 경우 **GetResourceTiling**은 <i>StartTileIndexInOverallResource</i> 멤버를 제외한 D3D12\_SUBRESOURCE\_TILING의 멤버를 0으로 설정하고, <i>StartTileIndexInOverallResource</i>는 D3D12\_PACKED\_TILE(0xffffffff)로 설정합니다. D3D12\_PACKED\_TILE 상수는 이 상황에서 전체 **D3D12\_SUBRESOURCE\_TILING** 구조체가 무의미하며, <i>pPackedMipDesc</i> 매개 변수가 가리키는 정보가 적용된다는 것을 나타냅니다.

### 반환 값

형식: void

없음.

## 설명

힙 크기를 계산하고 [CreatePlacedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public)를 호출할 때 필요한 텍스처의 총 리소스 크기를 추정하려면 **GetResourceTiling** 대신 [GetResourceAllocationInfo](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public)를 사용하세요.
**GetResourceTiling**은 이를 위해 사용할 수 없습니다.

타일 리소스에 대한 자세한 내용은 [볼륨 타일 리소스](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/volume-tiled-resources)를 참조하세요.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[하위 리소스](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/subresources)


## Related topics

- [D3D12_SUBRESOURCE_TILING](/ko/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md)
- [D3D12_TILE_SHAPE](/ko/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [GetResourceAllocationInfo](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public.md)
- [GetResourceAllocationInfo1 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_getresourceallocationinfo1_public.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)