Metodo ID3D12Device3::EnqueueMakeResident (d3d12.h)
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 |