Sintaxis
Parámetros
pDesc [in]Tipo: const D3D12_HEAP_DESC * Un puntero a una estructura constante D3D12_HEAP_DESC que describe el montón. pProtectedSession [in, optional]
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 montón debe estar protegido. Puede obtener un ID3D12ProtectedResourceSession llamando a ID3D12Device4::CreateProtectedResourceSession. Un montón con una sesión protegida no se puede crear con la marca D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER. riid [in]
Tipo: const IID & Una referencia al identificador único global (GUID) de la interfaz del montón que se 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 permitir la comprobación de capacidades. 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
CreateHeap1 crea un montón que se puede usar con recursos colocados y recursos reservados. Antes de liberar la referencia final del montón, la 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.hBiblioteca: d3d12_xs.lib
Plataformas compatibles: consolas XBOX Series