> ## 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.

# GetHeapProperties

> Recupera as propriedades do heap do recurso, para recursos posicionados e confirmados.

Recupera as propriedades do heap do recurso, para recursos posicionados e confirmados.

## Sintaxe

```cpp theme={null}
HRESULT GetHeapProperties(
    D3D12_HEAP_PROPERTIES  pHeapProperties,
    D3D12_HEAP_FLAGS  pHeapFlags
)
```

### Parâmetros

*pHeapProperties \[out, optional]*<br />Tipo: D3D12\_HEAP\_PROPERTIES \*

Ponteiro para uma estrutura [D3D12\_HEAP\_PROPERTIES](/pt-BR/reference/graphics/d3d12/structs/d3d12_heap_properties_public) que, após a conclusão bem-sucedida do método, conterá as propriedades do heap do recurso.

*pHeapFlags \[out, optional]*<br />Tipo: D3D12\_HEAP\_FLAGS \*

Especifica uma variável [D3D12\_HEAP\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_heap_flags) que, após a conclusão bem-sucedida do método, conterá quaisquer sinalizadores diversos do heap.

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues). Se o recurso tiver sido criado como reservado, E\_INVALIDARG será retornado.

## Comentários

Este método só funciona em recursos posicionados e confirmados, não em recursos reservados. Se o recurso tiver sido criado como reservado, E\_INVALIDARG será retornado. As páginas podem ser mapeadas para nenhum, um ou mais heaps.

Para obter mais informações, consulte [Gerenciamento de memória no Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/memory-management).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h<br />**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib<br />**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)


## Related topics

- [D3D12_HEAP_TYPE](/pt-BR/reference/graphics/d3d12/enums/d3d12_heap_type_public.md)
- [D3D12_CPU_PAGE_PROPERTY](/pt-BR/reference/graphics/d3d12/enums/d3d12_cpu_page_property_public.md)
- [ApuHeapGetState](/pt-BR/reference/audio/apu/functions/apuheapgetstate.md)
- [XMemGetTitleHeap](/pt-BR/reference/system/xmem/functions/xmemgettitleheap.md)
- [GetCPUDescriptorHandleForHeapStart](/pt-BR/reference/graphics/d3d12/interfaces/id3d12descriptorheap/methods/id3d12descriptorheap_getcpudescriptorhandleforheapstart_public.md)