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

# EnqueueMakeResident

> Torna objetos residentes para o dispositivo de forma assíncrona.

Torna objetos residentes para o dispositivo de forma assíncrona.

## Sintaxe

```cpp theme={null}
HRESULT EnqueueMakeResident(
    D3D12_RESIDENCY_FLAGS Flags,
    UINT NumObjects,
    ID3D12Pageable const  ppObjects,
    ID3D12Fence  pFenceToSignal,
    UINT64 FenceValueToSignal
)
```

### Parâmetros

*Flags*\
Tipo: D3D12\_RESIDENCY\_FLAGS

Controla se os objetos devem ser tornados residentes caso o aplicativo esteja acima do seu orçamento de memória.

*NumObjects*\
Tipo: UINT

O número de objetos na matriz *ppObjects* a serem tornados residentes para o dispositivo.

*ppObjects \[in]*\
Tipo: ID3D12Pageable \*const \*

Um ponteiro para um bloco de memória; contém uma matriz de ponteiros de interface [ID3D12Pageable](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public.md) para os objetos.

Embora a maioria dos objetos D3D12 herde de [ID3D12Pageable](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public.md), as alterações de residência só têm suporte nos seguintes:

<ul>
  <li>heaps de descritores</li>
  <li>heaps</li>
  <li>recursos confirmados</li>
  <li>heaps de consulta</li>
</ul>

*pFenceToSignal \[in]*\
Tipo: ID3D12Fence \*

Um ponteiro para o fence usado para sinalizar quando o trabalho for concluído.

*FenceValueToSignal*\
Tipo: UINT64

Um valor de 64 bits sem sinal sinalizado ao fence quando o trabalho for concluído.

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

## Comentários

**EnqueueMakeResident** executa as mesmas ações que [MakeResident](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public.md), mas não aguarda que os recursos sejam tornados residentes. Em vez disso, **EnqueueMakeResident** sinaliza um fence quando o trabalho é concluído.

O sistema não permitirá trabalho que faça referência aos recursos que estão sendo tornados residentes usando **EnqueueMakeResident** antes que seu fence seja sinalizado. Em vez disso, as chamadas para esta API têm a garantia de sinalizar seu fence correspondente em ordem, de modo que o mesmo fence possa ser usado de uma chamada para outra.

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

[ID3D12Device](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device.md)

[ID3D12Device3](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3.md)


## Related topics

- [D3D12_RESIDENCY_FLAGS](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_residency_flags_public.md)
- [MakeResident](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public.md)
- [ID3D12Pageable](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public.md)
- [EnqueueStatus](https://devdocs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [EnqueueRequest](https://devdocs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuerequest.md)