Skip to main content
Crea un montón que se puede usar con recursos colocados y recursos reservados.

Sintaxis

Parámetros

pDesc [in]
Tipo: const D3D12_HEAP_DESC *
Un puntero a una estructura constante D3D12_HEAP_DESC que describe el montón. riid [in]
Tipo: const IID &
Una referencia al identificador único global (GUID) de la interfaz de montón que se va a devolver en ppvHeap. Aunque riidResource suele ser el GUID de ID3D12Heap, 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. ppvHeap [out, optional]
Tipo: void **
Un puntero opcional a un bloque de memoria que recibe el puntero de interfaz solicitado al objeto de montón creado. ppvHeap puede ser nullptr para habilitar las pruebas de funcionalidades. Cuando ppvHeap 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

CreateHeap crea un montón que se puede usar con recursos colocados y recursos reservados. Antes de liberar la referencia final del montón, su aplicación debe asegurarse de que la GPU ya no leerá ni escribirá en este montón. Un objeto de recurso colocado mantiene una referencia al montón en el que se crea; pero un recurso reservado no mantiene una referencia por cada asignación realizada a un montón.

Requisitos

Encabezado: d3d12_xs.h o d3d12_x.h
Biblioteca: d3d12_xs.lib o d3d12_x.lib
Plataformas compatibles: consolas XBOX Series y familia XBOX One

Consulte también

ID3D12Device Montones compartidos
Última modificación el 28 de agosto de 2026