ID3D12Device3 ::EnqueueMakeResident, méthode (d3d12.h)
Rend de manière asynchrone les objets résidant pour l’appareil.
Syntaxe
HRESULT EnqueueMakeResident(
D3D12_RESIDENCY_FLAGS Flags,
UINT NumObjects,
[in] ID3D12Pageable * const *ppObjects,
[in] ID3D12Fence *pFenceToSignal,
UINT64 FenceValueToSignal
);
Paramètres
Flags
Type : D3D12_RESIDENCY_FLAGS
Contrôle si les objets doivent être rendus résidents si l’application dépasse son budget de mémoire.
NumObjects
Type : UINT
Nombre d’objets dans le tableau ppObjects à rendre résident pour l’appareil.
[in] ppObjects
Type : ID3D12Pageable*
Pointeur vers un bloc de mémoire ; contient un tableau de pointeurs d’interface ID3D12Pageables pour les objets.
Même si la plupart des objets D3D12 héritent d’ID3D12Pageable, les modifications de résidence sont uniquement prises en charge sur les points suivants :
- segments de descripteur
- segments
- ressources validées
- tas de requête
[in] pFenceToSignal
Type : ID3D12Fence*
Pointeur vers la clôture utilisée pour signaler quand le travail est terminé.
FenceValueToSignal
Type : UINT64
Une valeur 64 bits non signée a été signalée à la clôture lorsque le travail est terminé.
Valeur retournée
Type : HRESULT
Cette méthode retourne l’un des codes de retour Direct3D 12.
Remarques
EnqueueMakeResident effectue les mêmes actions que MakeResident, mais n’attend pas que les ressources soient rendues résidentes. Au lieu de cela, EnqueueMakeResident signale une clôture lorsque le travail est effectué.
Le système n’autorise pas le travail qui fait référence aux ressources qui sont rendues résidentes à l’aide d’EnqueueMakeResident avant que sa clôture ne soit signalée. Au lieu de cela, les appels à cette API sont garantis pour signaler leur clôture correspondante dans l’ordre, de sorte que la même clôture peut être utilisée d’un appel à l’autre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d12.h |
| Bibliothèque | D3D12.lib |
| DLL | D3D12.dll |