ID3D11DeviceContext1：：ClearView 方法 (d3d11_1.h)

  • 發行項

將資源檢視中的所有項目設定為一個值。

語法

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

參數

[in] pView

ID3D11View 介面的指標，表示要清除的資源檢視。

[in] Color

4 元件數位列，表示用來清除資源檢視的色彩。

[in, optional] pRect

要清除之資源檢視中矩形 的D3D11_RECT 結構數位。 如果 為NULL，ClearView 會清除整個表面。

NumRects

pRect 參數所指定數位中的矩形數目。

傳回值

無

備註

ClearView 僅適用於轉譯目標檢視 (RTV) 、深度/樣板檢視 (DSV) 僅限深度的資源， (資源) 、未排序存取檢視 (UAV) 或 Texture2D 表面的任何視訊檢視。 運行時間會卸除無效的呼叫。 pRect 陣列中的空白矩形是無作業。 如果頂端值等於底部值或左值等於右值，則矩形是空的。

ClearView 不支援 3D 紋理。

ClearView 會將相同的色彩值套用至檢視中的所有陣列配量; pRect 陣列中的所有矩形都對應至每個數位配量。 矩形的 pRect 陣列是在單一介面上清除的一組區域。 如果檢視是陣列， ClearView 會個別清除每個數位列配量上的所有矩形。

當您將矩形套用至緩衝區時，請將頂端值設定為0，並將底部值設定為1，並將左值和右值設定為描述緩衝區內的範圍。 當頂端值等於底部值或左值等於右值時，矩形是空的，而且達到無作業。

驅動程式會根據 Direct3D 轉換規則，將色彩值轉換成目的地格式。 例如，如果檢視的格式DXGI_FORMAT_R8G8B8A8_UNORM，驅動程式會將輸入限制為 0.0f 到 1.0f (+INF - 1.0f (0XFF) /NaN ->> 0.0f) 。

如果格式為整數，例如 DXGI_FORMAT_R8G8B8A8_UINT，運行時間會將輸入解譯為整數浮點數。 因此，235.0f 會對應至 235 (捨入為零、超出範圍/INF 值會固定至目標範圍，而 NaN 會) 。

以下是色彩對應：

  • Color[0]： 視訊 (或 Y)
  • Color[1]： G (或 U/Cb for video)
  • Color[2]： 影片) 的 B (或 V/Cr
  • Color[3]： A
對於具有 YUV 或 YCbBr 格式的視訊檢視， ClearView 不會轉換色彩值。 在格式名稱未指出_UNORM、_UINT等等的情況下， ClearView 會假設_UINT。 因此，235.0f 會對應至 235 (捨入為零、超出範圍/INF 值會固定至目標範圍，而 NaN 會) 。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d3d11_1.h
程式庫 D3D11.lib

另請參閱

ID3D11DeviceContext1