ID3D11DeviceContext1::DiscardView Method

Discards a resource view from the device context.

Syntax

public:
void DiscardView(
         ID3D11View *pResourceView
)

Parameters

pResourceView
Type: ID3D11View *

[in] A pointer to the ID3D11View interface for the resource view to discard. The resource that underlies the view must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardView; if the debug layer is enabled, the runtime returns an error message.

Return value

None.

Remarks

DiscardView informs the graphics processing unit (GPU) that the existing content in the resource view that pResourceView points to is no longer needed. The view can be an SRV, RTV, UAV, or DSV. DiscardView is a variation on the DiscardResource method. DiscardView allows you to discard a subset of a resource that is in a view (such as a single miplevel). More importantly, DiscardView provides a convenience because often views are what are being bound and unbound at the pipeline. Some pipeline bindings do not have views, such as stream output. In that situation, DiscardResource can do the job for any resource.

Requirements

Header: Declared in d3d11_x.h (d3d11_1.h on other Windows platforms).