Partager via

ID3D12Device3 ::EnqueueMakeResident, méthode (d3d12.h)

  • Article

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

Voir aussi

ID3D12Device

ID3D12Device3