D3DDDIARG_CLEAR 結構 (d3dumddi.h)

  • 發行項

D3DDDIARG_CLEAR 結構描述硬體輔助清除作業的參數。

語法

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

成員

[in] Flags

UINT 值，指定驅動程式應該清除哪些緩衝區，以及如何執行清除作業。 這個成員可以是下列值的位 OR。 如需詳細資訊，請參閱 清除 參考頁面中的一節。

ReplTest1 意義
D3DCLEAR_TARGET (0x00000001l) 驅動程式應該會將內容的轉譯目標清除為 FillColor 成員所指定的色彩。 此值定義於 D3d8types.h 中。
D3DCLEAR_STENCIL (0x00000004l) 驅動程式應該會將內容樣板緩衝區清除為 FillStencil 成員所指定的值。 此值定義於 D3d8types.h 中。
D3DCLEAR_ZBUFFER (0x00000002l) 驅動程式應該將內容的深度緩衝區清除為 FillDepth 成員所指定的深度。 此值定義於 D3d8types.h 中。
D3DCLEAR_COMPUTERECTS (0x00000008l) 如果已指定矩形來清除，驅動程式應該針對目前的檢視區裁剪這些矩形。 如果未指定矩形，驅動程式應該清除整個檢視區。 此值定義於 D3dhal.h 中。

[in] FillColor

驅動程式應清除內容轉譯目標的色彩值。

[in] FillDepth

驅動程式應該用來在內容的深度緩衝區中設定深度的值。 這個成員可以是範圍從 0.0 到 1.0 的值。

[in] FillStencil

驅動程式應該清除內容樣板緩衝區的值。 這個成員可以是介於 0 到 2ⁿ-1 範圍內的整數，其中 n 是樣板緩衝區中的位數。

備註

在呼叫使用者模式顯示驅動程式的 Clear 函式中，會傳遞 pData 參數中D3DDDIARG_CLEAR結構的指標。 Microsoft Direct3D 執行時間會將資訊傳遞至呼叫使用者模式顯示驅動程式的 Clear 函式中的 NumRect 和 pRect 參數，以指定驅動程式應該清除的緩衝區矩形區域。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 d3dumddi.h (include D3dumddi.h)

另請參閱

清除