Skip to main content
Crea un recurso confirmado con un diseño inicial en lugar de un estado inicial. Requiere DirectX 12 Agility SDK 1.7 o posterior.

​
Sintaxis

​
Parámetros

pHeapProperties
Tipo: const D3D12_HEAP_PROPERTIES * Un puntero a una estructura D3D12_HEAP_PROPERTIES que proporciona las propiedades del montón del recurso. HeapFlags
Tipo: D3D12_HEAP_FLAGS Opciones del montón, como una combinación mediante OR bit a bit de constantes de la enumeración D3D12_HEAP_FLAGS. pDesc
Tipo: const D3D12_RESOURCE_DESC1 * Un puntero a una estructura D3D12_RESOURCE_DESC1 que describe el recurso, incluida una región de mips. InitialLayout
Tipo: D3D12_BARRIER_LAYOUT El diseño inicial del recurso de textura; D3D12_BARRIER_LAYOUT::D3D12_BARRIER_LAYOUT_UNDEFINED para los búferes. pOptimizedClearValue
Tipo: const D3D12_CLEAR_VALUE * Especifica una estructura D3D12_CLEAR_VALUE que describe el valor predeterminado de un color de borrado. pOptimizedClearValue especifica un valor para el que las operaciones de borrado son más óptimas. Cuando el recurso creado es una textura con las marcas D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET o D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL, debe elegir el valor con el que se llamará más comúnmente a la operación de borrado. Puede llamar a la operación de borrado con otros valores, pero esas operaciones no serán tan eficientes como cuando el valor coincide con el que se pasó en la creación del recurso. Cuando use D3D12_RESOURCE_DIMENSION_BUFFER, debe establecer pOptimizedClearValue en nullptr. pProtectedSession
Tipo: ID3D12ProtectedResourceSession * Un puntero opcional a un objeto que representa una sesión para la protección de contenido. Si se proporciona, esta sesión indica que el recurso debe estar protegido. Puede obtener un ID3D12ProtectedResourceSession llamando a ID3D12Device4::CreateProtectedResourceSession. NumCastableFormats
Tipo: UINT32 El número de elementos de pCastableFormats. pCastableFormats
Tipo: DXGI_FORMAT * Una matriz contigua de estructuras DXGI_FORMAT a las que se puede convertir este recurso. riidResource
Tipo: const IID & Una referencia al identificador único global (GUID) de la interfaz del recurso que se devolverá en ppvResource. Aunque riidResource suele ser el GUID de ID3D12Resource, puede ser el GUID de cualquier interfaz. Si el objeto de recurso no admite la interfaz de este GUID, la creación produce un error E_NOINTERFACE. ppvResource
Tipo: void ** Un puntero opcional a un bloque de memoria que recibe el puntero de interfaz solicitado al objeto de recurso creado. ppvResource puede ser nullptr, para permitir la comprobación de capacidades. Cuando ppvResource es nullptr, no se crea ningún objeto y se devuelve S_FALSE cuando pDesc es válido.

​
Valor devuelto

Tipo: HRESULT Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT. Consulte códigos de retorno de Direct3D 12 para conocer otros valores devueltos posibles.

​
Comentarios

​
Requisitos

Encabezado: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas compatibles: consolas XBOX Series

​
Consulte también

ID3D12Device10
Última modificación el 28 de agosto de 2026

Temas relacionados

CreateCommittedResource1 (consolas XBOX Series)CreateReservedResource1 (consolas XBOX Series)CreateReservedResource2 (consolas XBOX Series)CreatePlacedResource2 (consolas XBOX Series)CreateHeap1 (consolas XBOX Series)