Método ID3D12GraphicsCommandList::D iscardResource (d3d12.h)

Indica que o conteúdo de um recurso não precisa ser preservado. A função pode inicializar novamente os metadados de recursos em alguns casos.

Sintaxe

void DiscardResource(
  ID3D12Resource             *pResource,
  const D3D12_DISCARD_REGION *pRegion
);

pResource

Um ponteiro para a interface ID3D12Resource para o recurso ser descartado.

pRegion

Tipo: [in, opcional] const D3D12_DISCARD_REGION*

Um ponteiro para uma estrutura de D3D12_DISCARD_REGION que descreve os detalhes da operação de descarte de recursos.

Nenhum

A semântica de DiscardResource é alterada com base no tipo de lista de comandos.

Para D3D12_COMMAND_LIST_TYPE_DIRECT, as duas regras a seguir se aplicam:

Quando um recurso tem o sinalizador D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET , DiscardResource deve ser chamado quando as regiões de sub-recursos descartadas estão no estado de barreira de recursos D3D12_RESOURCE_STATE_RENDER_TARGET .
Quando um recurso tem o sinalizador D3D12_RESOURCE_FLAG _ALLOW_DEPTH_STENCIL , DiscardResource deve ser chamado quando as regiões de sub-recursos descartadas estão no D3D12_RESOURCE_STATE_DEPTH_WRITE.

Para D3D12_COMMAND_LIST_TYPE_COMPUTE, a seguinte regra se aplica:

O recurso deve ter o sinalizador D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS e DiscardResource deve ser chamado quando as regiões de sub-recursos descartadas estiverem no estado de barreira de recursos D3D12_RESOURCE_STATE_UNORDERED_ACCESS .

Não há suporte para DiscardResource em listas de comandos com D3D12_COMMAND_LIST_TYPE_BUNDLE nem D3D12_COMMAND_LIST_TYPE_COPY.