ID3D11DeviceContext1::D iscardView1 メソッド (d3d11_1.h)

デバイス コンテキストからリソース ビュー内の指定された要素を破棄します。

構文

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

パラメーター

[in] pResourceView

種類: ID3D11View*

リソース ビューが破棄する ID3D11View インターフェイスへのポインター。 ビューの基になるリソースは、使用状況 D3D11_USAGE_DEFAULT または D3D11_USAGE_DYNAMICで作成されている必要があります。それ以外の場合、ランタイムは DiscardView1 の呼び出しをドロップします。デバッグ レイヤーが有効になっている場合、ランタイムはエラー メッセージを返します。

[in, optional] pRects

型: const D3D11_RECT*

破棄するリソース ビュー内の四角形の D3D11_RECT 構造体の配列。 NULL の場合、DiscardView1 はビュー全体を破棄し、DiscardView と同じように動作します。

NumRects

型: UINT

pRects パラメーターが指定する配列内の四角形の数。

戻り値

なし

解説

DiscardView1 は、 pResourceView が指すリソース ビュー内の指定された要素内の既存のコンテンツが不要になったことをグラフィックス処理装置 (GPU) に通知します。 ビューには、SRV、RTV、UAV、または DSV を指定できます。 DiscardView1 は DiscardResource メソッドのバリエーションです。 DiscardView1 を使用すると、ビュー内にあるリソースのサブセットの要素 (1 つの miplevel の要素など) を破棄できます。 さらに重要なのは、 DiscardView1 は、多くの場合、パイプラインでバインドされているビューとバインドされていないビューであるため、便利です。 一部のパイプライン バインドには、ストリーム出力などのビューがありません。 その場合、 DiscardResource は任意のリソースに対してジョブを実行できます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d3d11_1.h
Library	D3D11.lib

こちらもご覧ください

ID3D11DeviceContext1