Syntaxe
Paramètres
pDesc [in]Type : const D3D12_RESOURCE_DESC * Pointeur vers une structure D3D12_RESOURCE_DESC qui décrit la ressource. InitialState [in]
Type : D3D12_RESOURCE_STATES État initial de la ressource, sous forme de combinaison par OU au niveau du bit de constantes de l’énumération D3D12_RESOURCE_STATES. pOptimizedClearValue [in, optional]
Type : const D3D12_CLEAR_VALUE * Spécifie une structure D3D12_CLEAR_VALUE qui décrit la valeur par défaut d’une couleur d’effacement. pOptimizedClearValue spécifie une valeur pour laquelle les opérations d’effacement sont les plus optimales. Lorsque la ressource créée est une texture comportant l’indicateur D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET ou D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL, vous devez choisir la valeur avec laquelle l’opération d’effacement sera le plus souvent appelée. Vous pouvez appeler l’opération d’effacement avec d’autres valeurs, mais ces opérations ne seront pas aussi efficaces que lorsque la valeur correspond à celle passée lors de la création de la ressource. Lorsque vous utilisez D3D12_RESOURCE_DIMENSION_BUFFER, vous devez définir pOptimizedClearValue à
nullptr.
riid [in]Type : const IID & Référence à l’identificateur global unique (GUID) de l’interface de ressource à retourner dans ppvResource. Consultez Remarques. Bien que riidResource soit le plus souvent le GUID de ID3D12Resource, il peut s’agir du GUID de n’importe quelle interface. Si l’objet ressource ne prend pas en charge l’interface de ce GUID, la création échoue avec E_NOINTERFACE. ppvResource [out, optional]
Type : void ** Pointeur facultatif vers un bloc de mémoire qui reçoit le pointeur d’interface demandé vers l’objet ressource créé. ppvResource peut être
nullptr afin de permettre le test des capacités. Lorsque ppvResource est nullptr, aucun objet n’est créé et S_FALSE est retourné lorsque pDesc est valide.
Valeur de retour
Type : HRESULT Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Consultez Codes de retour Direct3D 12 pour connaître les autres valeurs de retour possibles.
Remarques
CreateReservedResource équivaut à D3D11_RESOURCE_MISC_TILED dans Direct3D 11. Elle crée une ressource uniquement en mémoire virtuelle, sans stockage de sauvegarde. Vous devez mapper la ressource à la mémoire physique (c’est-à-dire à un tas) à l’aide de CopyTileMappings et de UpdateTileMappings. Ces types de ressources ne peuvent être créés que lorsque l’adaptateur prend en charge le niveau 1 ou supérieur des ressources en mosaïque. Le niveau des ressources en mosaïque définit le comportement de l’accès à une ressource qui n’est pas mappée à un tas.Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One