Método ID3D11DeviceContext1::D iscardView1 (d3d11_1.h)

Descarta os elementos especificados em uma exibição de recurso do contexto do dispositivo.

Sintaxe

void DiscardView1(
  [in]           ID3D11View       *pResourceView,
  [in, optional] const D3D11_RECT *pRects,
                 UINT             NumRects
);

Parâmetros

[in] pResourceView

Tipo: ID3D11View*

Um ponteiro para a interface ID3D11View para a exibição de recurso a ser descartada. O recurso subjacente à exibição deve ter sido criado com D3D11_USAGE_DEFAULT de uso ou D3D11_USAGE_DYNAMIC, caso contrário, o runtime descarta a chamada para DiscardView1; se a camada de depuração estiver habilitada, o runtime retornará uma mensagem de erro.

[in, optional] pRects

Tipo: const D3D11_RECT*

Uma matriz de estruturas de D3D11_RECT para os retângulos na exibição de recurso a serem descartados. Se NULL, DiscardView1 descartará toda a exibição e se comportará da mesma forma que DiscardView.

NumRects

Tipo: UINT

Número de retângulos na matriz especificada pelo parâmetro pRects .

Retornar valor

Nenhum

Comentários

DiscardView1 informa à GPU (unidade de processamento gráfico) que o conteúdo existente nos elementos especificados na exibição de recurso para o qual pResourceView aponta não é mais necessário. A exibição pode ser uma SRV, RTV, UAV ou DSV. DiscardView1 é uma variação no método DiscardResource . DiscardView1 permite descartar elementos de um subconjunto de um recurso que está em uma exibição (como elementos de um único mil). Mais importante, DiscardView1 fornece uma conveniência porque muitas vezes as exibições são o que está sendo associado e desvinculado no pipeline. Algumas associações de pipeline não têm exibições, como saída de fluxo. Nessa situação, DiscardResource pode fazer o trabalho para qualquer recurso.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d3d11_1.h
Biblioteca	D3D11.lib

Confira também

ID3D11DeviceContext1