> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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]*\
Tipo: D3D12\_HEAP\_PROPERTIES \*

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

*pHeapFlags \[out, optional]*\
Tipo: D3D12\_HEAP\_FLAGS \*

Especifica uma variável [D3D12\_HEAP\_FLAGS](https://docs.xbox.com/pt-BR/reference/graphics/d3d12_x/enums/d3d12_heap_flags.md) 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\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12Resource](https://docs.xbox.com/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs.md)


## Related topics

- [D3D12_HEAP_TYPE](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_heap_type_public.md)
- [D3D12_CPU_PAGE_PROPERTY](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_cpu_page_property_public.md)
- [ApuHeapGetState](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apuheapgetstate.md)
- [XMemGetTitleHeap](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemgettitleheap.md)
- [XMemGetWin32HeapName](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemgetwin32heapname.md)