Metodo ID3D12Device3::EnqueueMakeResident (d3d12.h)

  • Articolo

Rende gli oggetti residenti in modo asincrono per il dispositivo.

Sintassi

HRESULT EnqueueMakeResident(
       D3D12_RESIDENCY_FLAGS Flags,
       UINT                  NumObjects,
  [in] ID3D12Pageable        * const *ppObjects,
  [in] ID3D12Fence           *pFenceToSignal,
       UINT64                FenceValueToSignal
);

Parametri

Flags

Tipo: D3D12_RESIDENCY_FLAGS

Controlla se gli oggetti devono essere resi residenti se l'applicazione è superiore al budget di memoria.

NumObjects

Tipo: UINT

Numero di oggetti nella matrice ppObjects per rendere residente il dispositivo.

[in] ppObjects

Tipo: ID3D12Pageable*

Puntatore a un blocco di memoria; contiene una matrice di puntatori dell'interfaccia ID3D12Pageable per gli oggetti.

Anche se la maggior parte degli oggetti D3D12 eredita da ID3D12Pageable, le modifiche di residenza sono supportate solo nelle seguenti:

  • descrittore heaps
  • heap
  • risorse commit
  • heaps di query

[in] pFenceToSignal

Tipo: ID3D12Fence*

Puntatore alla recinzione usata per segnalare quando viene eseguito il lavoro.

FenceValueToSignal

Tipo: UINT64

Valore senza segno a 64 bit segnalato alla recinzione al termine del lavoro.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 12.

Commenti

EnqueueMakeResident esegue le stesse azioni di MakeResident, ma non attende che le risorse vengano effettuate in residenza. Invece, EnqueueMakeResident segnala una recinzione al termine del lavoro.

Il sistema non consente il lavoro che fa riferimento alle risorse che vengono effettuate residenti usando EnqueueMakeResident prima che venga segnalato il suo recinto. Le chiamate a questa API sono invece garantite di segnalare il loro recinto corrispondente in ordine, in modo che la stessa recinzione possa essere usata dalla chiamata alla chiamata.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d12.h
Libreria D3D12.lib
DLL D3D12.dll

Vedi anche

ID3D12Device

ID3D12Device3