Skip to main content
Cria um recurso e um heap implícito grande o suficiente para conter o recurso inteiro. O recurso é mapeado para o heap.

​
Sintaxe

​
Parâmetros

pHeapProperties _In_
Tipo: D3D12_HEAP_PROPERTIES* Um ponteiro para uma estrutura D3D12_HEAP_PROPERTIES que fornece propriedades para o heap do recurso. HeapFlags
Tipo: D3D12_HEAP_FLAGS Opções de heap como uma combinação OR bit a bit de constantes de enumeração D3D12_HEAP_FLAGS. pResourceDesc _In_
Tipo: D3D12XBOX_RESOURCE_DESC* Um ponteiro para uma estrutura D3D12XBOX_RESOURCE_DESC que descreve o recurso. InitialState
Tipo: D3D12_RESOURCE_STATES O estado inicial do recurso, como uma combinação OR bit a bit de constantes de enumeração D3D12_RESOURCE_STATES. Quando um recurso é criado junto com um heap D3D12_HEAP_TYPE_UPLOAD, InitialState deve ser D3D_RESOURCE_STATE_GENERIC_READ. Quando um recurso é criado junto com um heap D3D12_HEAP_TYPE_READBACK, InitialState deve ser D3D12_RESOURCE_STATE_COPY_DEST. pOptimizedClearValue _In_opt_
Tipo: D3D12_CLEAR_VALUE* Especifica um D3D12_CLEAR_VALUE que descreve o valor padrão de uma cor de limpeza. riidResource
Tipo: REFIID O GUID (identificador global exclusivo) da interface do recurso. Este é um parâmetro de entrada. Para recuperar o REFIID (ou GUID) da interface para a fila de comandos, use a macro __uuidof(). Por exemplo, para obter o GUID da interface para um recurso:
Embora riidResource seja mais comumente o GUID de ID3D12Resource, ele pode ser qualquer GUID de qualquer interface. Se o objeto de recurso não der suporte à interface desse GUID, a criação falhará e retornará E_NOINTERFACE. ppvResource _Outptr_opt_
Tipo: void** Um ponteiro para a memória que recebe o ponteiro de interface solicitado para o objeto de recurso criado. ppvResource pode ser null, para habilitar o teste de funcionalidades; quando CreateCommittedResourceX é chamado com ppvResource definido como null, nenhum objeto será criado e S_FALSE será retornado quando pResourceDesc for válido.

​
Valor retornado

Tipo: HRESULT E_OUTOFMEMORY se não houver memória suficiente para criar o recurso. Para outros valores retornados possíveis, confira os códigos de retorno do Direct3D 12.

​
Comentários

Esta função cria um recurso e um heap implícito grande o suficiente para conter o recurso inteiro, que é mapeado nele. O aplicativo não pode obter o heap criado. O aplicativo deve garantir que a GPU não possa mais ler ou gravar nesse recurso antes de liberar a referência final ao recurso. O heap implícito se torna residente para acesso da GPU antes que a função retorne ao aplicativo. Para obter mais informações, confira Residência. O mapeamento de VA da GPU do recurso não pode ser alterado. Para obter mais informações, confira UpdateTileMappings e Recursos em blocos de volume. Esta função é thread-safe.

​
Requisitos

Cabeçalho: d3d12_x.h Biblioteca: d3d12_x.lib Plataformas com suporte: família XBOX One

​
Confira também

ID3D12Device
Last modified on October 6, 2026