Sintaxis
Parámetros
pHeapTipo: ID3D12Heap * Un puntero a la interfaz ID3D12Heap que representa el montón en el que se coloca el recurso. HeapOffset
Tipo: UINT64 El desplazamiento, en bytes, hasta el recurso. HeapOffset debe ser un múltiplo de la alineación del recurso, y HeapOffset más el tamaño del recurso debe ser menor o igual que el tamaño del montón. Debe usarse GetResourceAllocationInfo para conocer los tamaños de los recursos de textura. pDesc
Tipo: const D3D12_RESOURCE_DESC * Un puntero a una estructura D3D12_RESOURCE_DESC que describe el recurso. InitialState
Tipo: D3D12_RESOURCE_STATES El estado inicial del recurso, como una combinación con OR bit a bit de constantes de la enumeración D3D12_RESOURCE_STATES. Cuando un recurso se crea junto con un montón D3D12_HEAP_TYPE_UPLOAD, InitialState debe ser D3D12_RESOURCE_STATE_GENERIC_READ. Cuando un recurso se crea junto con un montón D3D12_HEAP_TYPE_READBACK, InitialState debe ser D3D12_RESOURCE_STATE_COPY_DEST. pOptimizedClearValue
Tipo: const D3D12_CLEAR_VALUE * Especifica un D3D12_CLEAR_VALUE que describe el valor predeterminado para 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, su aplicación debe elegir el valor con el que se llamará más habitualmente a la operación de borrado. Las operaciones de borrado pueden llamarse con otros valores, pero esas operaciones no serán tan eficientes como cuando el valor coincide con el que se pasó al crear el recurso. pOptimizedClearValue debe ser NULL cuando se usa con D3D12_RESOURCE_DIMENSION_BUFFER. riid
Tipo: const IID & El identificador único global (GUID) de la interfaz del recurso. Este es un parámetro de entrada. El REFIID, o GUID, de la interfaz del recurso puede obtenerse mediante la macro
__uuidof. Por ejemplo, __uuidof(ID3D12Resource) obtiene el GUID de la interfaz de un recurso. Aunque riid es, más habitualmente, el GUID de ID3D12Resource, puede ser cualquier GUID de cualquier interfaz. Si el objeto de recurso no admite la interfaz de este GUID, la creación falla con E_NOINTERFACE.
ppvResourceTipo: void ** Un puntero a un bloque de memoria que recibe un puntero al recurso. ppvResource puede ser NULL, para habilitar las pruebas de capacidad. Cuando ppvResource es NULL, no se creará ningún objeto y se devolverá S_FALSE cuando pResourceDesc y los demás parámetros sean válidos.
Valor devuelto
Tipo: HRESULT Este método devuelve E_OUTOFMEMORY si no hay memoria suficiente para crear el recurso. Consulte Códigos de retorno de Direct3D 12 para conocer otros posibles valores devueltos.Comentarios
CreatePlacedResource es similar a asignar por completo un recurso reservado a un desplazamiento dentro de un montón; pero el espacio de direcciones virtuales asociado a un montón también puede reutilizarse. Los recursos colocados son más ligeros de crear y destruir que los recursos confirmados. Esto se debe a que no se crea ni se destruye ningún montón durante esas operaciones. Además, los recursos colocados permiten una técnica aún más ligera para reutilizar la memoria que la creación y destrucción de recursos, es decir, la reutilización mediante alias y barreras de alias. Varios recursos colocados pueden superponerse simultáneamente entre sí en el mismo montón, pero solo se puede usar un único recurso superpuesto a la vez. Existen dos semánticas de uso de recursos colocados: un modelo simple y un modelo avanzado. Le recomendamos que elija el modelo simple (maximiza la compatibilidad con las herramientas de gráficos en el diverso ecosistema de GPU), a menos que descubra que necesita el modelo avanzado para su aplicación, y hasta que eso ocurra.Modelo simple
En este modelo, puede considerar que un recurso colocado está en uno de dos estados: activo o inactivo. No es válido que la GPU lea o escriba desde un recurso inactivo. Los recursos colocados se crean en el estado inactivo. Para activar un recurso con una barrera de alias en una lista de comandos, su aplicación debe pasar el recurso en D3D12_RESOURCE_ALIASING_BARRIER::pResourceAfter. pResourceBefore puede dejarse en NULL durante una activación. Todos los recursos que comparten memoria física con el recurso activado pasan a estar inactivos, lo que incluye los recursos colocados y reservados superpuestos. Las barreras de alias deben agruparse y enviarse juntas, para maximizar la eficiencia. Después de la activación, los recursos con las marcas de destino de representación o de galería de símbolos de profundidad deben inicializarse adicionalmente. Consulte las notas sobre la inicialización de recursos necesaria a continuación.Notas sobre la inicialización de recursos necesaria
Ciertos tipos de recursos siguen requiriendo inicialización. Los recursos con las marcas de destino de representación o de galería de símbolos de profundidad deben inicializarse con una operación de borrado o con una colección de copias completas de subrecursos. Si se usó una barrera de alias para indicar la transición entre dos recursos con alias, la inicialización debe producirse después de la barrera de alias. Esta inicialización sigue siendo necesaria siempre que un recurso se hubiera activado en el modelo simple. Los recursos colocados y reservados con las marcas de destino de representación o de galería de símbolos de profundidad deben inicializarse con una de las siguientes operaciones antes de que se admitan otras operaciones.- Una operación de borrado (Clear); por ejemplo, ClearRenderTargetView o ClearDepthStencilView.
- Una operación DiscardResource.
- Una operación de copia (Copy); por ejemplo, CopyBufferRegion, CopyTextureRegion o CopyResource.
- Usar un búfer de profundidad para resolver la visibilidad de píxeles normalmente requiere que cada texel de profundidad comience en 1.0 o 0. Por lo tanto, una operación de borrado debería ser la opción más eficiente para la inicialización de un búfer de profundidad con alias.
- Una aplicación puede usar un destino de representación con alias como destino para la asignación de tonos. Dado que la aplicación representará sobre cada píxel durante la asignación de tonos, DiscardResource debería ser la opción más eficiente para la inicialización.
Modelo avanzado
En este modelo, puede ignorar la abstracción de estados activo/inactivo. En su lugar, debe respetar estas reglas de nivel inferior.- Debe haber una barrera de alias entre dos accesos de recursos de GPU diferentes a la misma memoria física, siempre que esos accesos estén dentro de la misma llamada a ExecuteCommandLists.
- La primera operación de representación en ciertos tipos de recursos con alias debe seguir siendo una inicialización, igual que en el modelo simple.
Notas sobre la barrera de alias
La barrera de alias puede establecer NULL tanto para pResourceAfter como para pResourceBefore. La definición de coherencia de memoria de ExecuteCommandLists y de una barrera de alias es la misma, de modo que dos accesos con alias a la misma memoria física no necesitan ninguna barrera de alias cuando los accesos se producen en dos invocaciones diferentes de ExecuteCommandLists. Para los modelos de uso avanzado de D3D12, la definición de sincronización de ExecuteCommandLists es equivalente a una barrera de alias. Por lo tanto, las aplicaciones pueden insertar una barrera de alias entre reutilizaciones de la memoria física, o asegurarse de que los dos usos con alias de la memoria física se produzcan en dos llamadas independientes a ExecuteCommandLists. La cantidad de inactivación varía según las propiedades del recurso. Las texturas con diseños de memoria indefinidos son el peor caso, ya que toda la textura debe inactivarse de forma atómica. Para dos recursos superpuestos con diseños definidos, la inactivación puede afectar solo a las regiones alineadas superpuestas de un recurso. La herencia de datos puede incluso estar bien definida. Para obtener más información, consulte Alias de memoria y herencia de datos.Requisitos
Encabezado: d3d12_xs.h o d3d12_x.hBiblioteca: d3d12_xs.lib o d3d12_x.lib
Plataformas compatibles: consolas XBOX Series y familia XBOX One