Syntaxe
Paramètres
pDesc [in]Type : const D3D12_HEAP_DESC * Pointeur vers une structure D3D12_HEAP_DESC constante qui décrit le tas. pProtectedSession [in, optional]
Type : ID3D12ProtectedResourceSession * Pointeur facultatif vers un objet qui représente une session de protection du contenu. S’il est fourni, cette session indique que le tas doit être protégé. Vous pouvez obtenir un ID3D12ProtectedResourceSession en appelant ID3D12Device4::CreateProtectedResourceSession. Un tas avec une session protégée ne peut pas être créé avec l’indicateur D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER. riid [in]
Type : const IID & Référence à l’identificateur global unique (GUID) de l’interface de tas à renvoyer dans ppvHeap. Bien que riidResource soit le plus souvent le GUID de ID3D12Heap, il peut s’agir du GUID de n’importe quelle interface. Si l’objet ressource ne prend pas en charge l’interface correspondant à ce GUID, la création échoue avec E_NOINTERFACE. ppvHeap [out, optional]
Type : void ** Pointeur facultatif vers un bloc de mémoire qui reçoit le pointeur d’interface demandé vers l’objet tas créé. ppvHeap peut être
nullptr, afin de permettre le test des capacités. Lorsque ppvHeap est nullptr, aucun objet n’est créé et S_FALSE est renvoyé si pDesc est valide.
Valeur renvoyée
Type : HRESULT Si la fonction réussit, elle renvoie S_OK. Sinon, elle renvoie un code d’erreur HRESULT.
Consultez Codes de retour Direct3D 12 pour connaître les autres valeurs de retour possibles.
Remarques
CreateHeap1 crée un tas qui peut être utilisé avec des ressources placées et des ressources réservées. Avant de libérer la dernière référence au tas, votre application doit s’assurer que le GPU ne lira plus et n’écrira plus dans ce tas. Un objet ressource placée conserve une référence au tas sur lequel il est créé ; en revanche, une ressource réservée ne conserve pas de référence pour chaque mappage effectué vers un tas.Configuration requise
En-tête : d3d12_xs.hBibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series