Sintaxe
Parâmetros
pHeapTipo: ID3D12Heap * Um ponteiro para a interface ID3D12Heap que representa o heap no qual o recurso é posicionado. HeapOffset
Tipo: UINT64 O deslocamento, em bytes, até o recurso. O HeapOffset deve ser um múltiplo do alinhamento do recurso, e HeapOffset mais o tamanho do recurso deve ser menor ou igual ao tamanho do heap. GetResourceAllocationInfo deve ser usado para entender os tamanhos dos recursos de textura. pDesc
Tipo: const D3D12_RESOURCE_DESC * Um ponteiro para uma estrutura D3D12_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 D3D12_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
Tipo: const D3D12_CLEAR_VALUE * Especifica um D3D12_CLEAR_VALUE que descreve o valor padrão de uma cor de limpeza. pOptimizedClearValue especifica um valor para o qual as operações de limpeza são mais otimizadas. Quando o recurso criado é uma textura com os sinalizadores D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET ou D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL, seu aplicativo deve escolher o valor com o qual a operação de limpeza será chamada com mais frequência. As operações de limpeza podem ser chamadas com outros valores, mas essas operações não serão tão eficientes quanto quando o valor corresponde ao passado na criação do recurso. pOptimizedClearValue deve ser NULL quando usado com D3D12_RESOURCE_DIMENSION_BUFFER. riid
Tipo: const IID & O identificador global exclusivo (GUID) da interface do recurso. Este é um parâmetro de entrada. O REFIID, ou GUID, da interface do recurso pode ser obtido usando a macro
__uuidof. Por exemplo, __uuidof(ID3D12Resource) obtém o GUID da interface de um recurso. Embora riid 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á com E_NOINTERFACE.
ppvResourceTipo: void ** Um ponteiro para um bloco de memória que recebe um ponteiro para o recurso. ppvResource pode ser NULL, para permitir o teste de funcionalidades. Quando ppvResource é NULL, nenhum objeto será criado e S_FALSE será retornado quando pResourceDesc e os outros parâmetros forem válidos.
Valor retornado
Tipo: HRESULT Este método retorna E_OUTOFMEMORY se não houver memória suficiente para criar o recurso. Confira Códigos de retorno do Direct3D 12 para outros valores de retorno possíveis.Comentários
CreatePlacedResource é semelhante a mapear totalmente um recurso reservado para um deslocamento dentro de um heap; mas o espaço de endereço virtual associado a um heap também pode ser reutilizado. Os recursos posicionados são mais leves de criar e destruir do que os recursos confirmados. Isso ocorre porque nenhum heap é criado nem destruído durante essas operações. Além disso, os recursos posicionados permitem uma técnica ainda mais leve de reutilizar memória do que a criação e destruição de recursos, ou seja, a reutilização por meio de aliasing e barreiras de aliasing. Vários recursos posicionados podem se sobrepor simultaneamente no mesmo heap, mas apenas um único recurso sobreposto pode ser usado por vez. Há duas semânticas de uso de recursos posicionados: um modelo simples e um modelo avançado. Recomendamos que você escolha o modelo simples (ele maximiza o suporte das ferramentas gráficas em todo o ecossistema diversificado de GPUs), a menos que e até que você descubra que precisa do modelo avançado para seu aplicativo.Modelo simples
Nesse modelo, você pode considerar que um recurso posicionado está em um de dois estados: ativo ou inativo. É inválido que a GPU leia ou grave em um recurso inativo. Os recursos posicionados são criados no estado inativo. Para ativar um recurso com uma barreira de aliasing em uma lista de comandos, seu aplicativo deve passar o recurso em D3D12_RESOURCE_ALIASING_BARRIER::pResourceAfter. pResourceBefore pode ser deixado como NULL durante uma ativação. Todos os recursos que compartilham memória física com o recurso ativado passam a ficar inativos, o que inclui recursos posicionados e reservados sobrepostos. As barreiras de aliasing devem ser agrupadas e enviadas juntas, para maximizar a eficiência. Após a ativação, os recursos com os sinalizadores de destino de renderização ou de estêncil de profundidade devem ser inicializados adicionalmente. Confira as observações sobre a inicialização de recursos necessária abaixo.Observações sobre a inicialização de recursos necessária
Certos tipos de recursos ainda exigem inicialização. Os recursos com os sinalizadores de destino de renderização ou de estêncil de profundidade devem ser inicializados com uma operação de limpeza ou com uma coleção de cópias completas de sub-recursos. Se uma barreira de aliasing tiver sido usada para indicar a transição entre dois recursos com aliasing, a inicialização deverá ocorrer após a barreira de aliasing. Essa inicialização ainda é necessária sempre que um recurso seria ativado no modelo simples. Os recursos posicionados e reservados com os sinalizadores de destino de renderização ou de estêncil de profundidade devem ser inicializados com uma das operações a seguir antes que outras operações tenham suporte.- Uma operação Clear; por exemplo, ClearRenderTargetView ou ClearDepthStencilView.
- Uma operação DiscardResource.
- Uma operação Copy; por exemplo, CopyBufferRegion, CopyTextureRegion ou CopyResource.
- Usar um buffer de profundidade para resolver a visibilidade de pixels normalmente exige que cada texel de profundidade comece em 1,0 ou 0. Portanto, uma operação Clear deve ser a opção mais eficiente para a inicialização de um buffer de profundidade com aliasing.
- Um aplicativo pode usar um destino de renderização com aliasing como destino para o mapeamento de tons. Como o aplicativo renderizará sobre cada pixel durante o mapeamento de tons, DiscardResource deve ser a opção mais eficiente para a inicialização.
Modelo avançado
Nesse modelo, você pode ignorar a abstração de estado ativo/inativo. Em vez disso, você deve respeitar estas regras de nível inferior.- Uma barreira de aliasing deve estar entre dois acessos diferentes de recursos de GPU à mesma memória física, desde que esses acessos estejam dentro da mesma chamada de ExecuteCommandLists.
- A primeira operação de renderização em certos tipos de recursos com aliasing ainda deve ser uma inicialização, assim como no modelo simples.
Observações sobre a barreira de aliasing
A barreira de aliasing pode definir NULL tanto para pResourceAfter quanto para pResourceBefore. A definição de coerência de memória de ExecuteCommandLists e a de uma barreira de aliasing são iguais, de modo que dois acessos com aliasing à mesma memória física não precisam de barreira de aliasing quando os acessos estão em duas invocações diferentes de ExecuteCommandLists. Para os modelos de uso avançado do D3D12, a definição de sincronização de ExecuteCommandLists é equivalente a uma barreira de aliasing. Portanto, os aplicativos podem inserir uma barreira de aliasing entre reutilizações de memória física ou garantir que os dois usos com aliasing da memória física ocorram em duas chamadas separadas para ExecuteCommandLists. A quantidade de inativação varia de acordo com as propriedades do recurso. As texturas com layouts de memória indefinidos são o pior caso, pois a textura inteira deve ser inativada atomicamente. Para dois recursos sobrepostos com layouts definidos, a inativação pode resultar apenas nas regiões alinhadas sobrepostas de um recurso. A herança de dados pode até ser bem definida. Para obter mais detalhes, confira Aliasing de memória e herança de dados.Requisitos
Cabeçalho: d3d12_xs.h ou d3d12_x.hBiblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One