Passer au contenu principal
Place un composant d’une ressource (sous-ressource).

Syntaxe

Paramètres

pComponentLocations _In_
Type : D3D12XBOX_COMPONENT_PLACED_ADDRESSES*
Emplacements des composants, sous forme de structure D3D12XBOX_COMPONENT_PLACED_ADDRESSES. pDesc _In_
Type : D3D12_RESOURCE_DESC1*
Description de la ressource ou de la sous-ressource, sous forme de pointeur vers une structure D3D12_RESOURCE_DESC1. InitialLayout
Type : D3D12_BARRIER_LAYOUT
Disposition initiale de la ressource de texture; D3D12_BARRIER_LAYOUT::D3D12_BARRIER_LAYOUT_UNDEFINED pour les mémoires tampons. pOptimizedClearValue _In_opt_
Type : D3D12_CLEAR_VALUE*
Valeur optimisée à utiliser pour effacer le composant, sous forme de pointeur vers une structure D3D12_CLEAR_VALUE. riid
Type : REFIID
Identificateur global unique (GUID) de l’interface de ressource, ID3D12Resource. Pour récupérer le REFIID (ou GUID) de l’interface de la ressource, utilisez la macro __uuidof(). Par exemple, pour obtenir le GUID de l’interface d’une liste de commandes, procédez comme suit :
ppvResource _Outptr_opt_
Type : void**
La ressource.

Valeur de retour

Type : HRESULT L’un des codes de retour Direct3D 12.

Remarques

Utilisez CreateComponentPlacedResourceX2 pour créer, au moment de l’exécution, les ressources hors ligne et de placement que vous pouvez prétraiter à l’aide de la bibliothèque XG. La bibliothèque XG fournit une disposition pour les paramètres FMask et CMask. CreateComponentPlacedResourceX2 est semblable à CreatePlacedResourceX1, mais permet au titre de spécifier jusqu’à quatre adresses virtuelles distinctes qui représentent les différentes parties de la ressource. Contrairement à CreateComponentPlacedResourceX1, cette méthode accepte une structure D3D12_RESOURCE_DESC1 afin de permettre l’utilisation d’une région mip de rétroaction d’échantillonneur.

Configuration requise

En-tête : d3d12_xs.h
Bibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series

Voir aussi

ID3D12Device11 CreateComponentPlacedResourceX CreateComponentPlacedResourceX1 CreatePlacedResourceX1
Dernière modification le 6 octobre 2026