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

Indica que no es necesario conservar el contenido de un recurso. La función puede volver a inicializar los metadatos de recursos en algunos casos.

Sintaxis

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

pResource

Puntero a la interfaz ID3D12Resource del recurso que se va a descartar.

pRegion

Tipo: [in, opcional] const D3D12_DISCARD_REGION*

Puntero a una estructura de D3D12_DISCARD_REGION que describe los detalles de la operación de descarte-recurso.

Ninguno

Semántica del cambio de DiscardResource en función del tipo de lista de comandos.

Para D3D12_COMMAND_LIST_TYPE_DIRECT, se aplican las dos reglas siguientes:

Cuando un recurso tiene la marca D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET , se debe llamar a DiscardResource cuando las regiones de subrecurso descartadas se encuentran en el estado de barrera de recursos D3D12_RESOURCE_STATE_RENDER_TARGET .
Cuando un recurso tiene la marca D3D12_RESOURCE_FLAG _ALLOW_DEPTH_STENCIL , se debe llamar a DiscardResource cuando las regiones de subrecurso descartadas se encuentran en el D3D12_RESOURCE_STATE_DEPTH_WRITE.

Para D3D12_COMMAND_LIST_TYPE_COMPUTE, se aplica la siguiente regla:

El recurso debe tener la marca D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS y se debe llamar a DiscardResource cuando las regiones de subrecurso descartadas están en el estado de barrera de recursos D3D12_RESOURCE_STATE_UNORDERED_ACCESS .

DiscardResource no se admite en listas de comandos con D3D12_COMMAND_LIST_TYPE_BUNDLE ni D3D12_COMMAND_LIST_TYPE_COPY.