Pular para o conteúdo principal
Torna objetos residentes para o dispositivo de forma assíncrona.

​
Sintaxe

​
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 para os objetos. Embora a maioria dos objetos D3D12 herde de ID3D12Pageable, as alterações de residência só têm suporte nos seguintes:
  • heaps de descritores
  • heaps
  • recursos confirmados
  • heaps de consulta
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.

​
Comentários

EnqueueMakeResident executa as mesmas ações que MakeResident, 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 ID3D12Device3
Última modificação em 19 de outubro de 2026