共用方式為


PFND3D10DDI_CLEARDEPTHSTENCILVIEW回呼函式 (d3d10umddi.h)

ClearDepthStencilView 函式會清除指定的目前系結深度樣板檢視。

語法

PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;

void Pfnd3d10ddiCleardepthstencilview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
  UINT unnamedParam3,
  FLOAT unnamedParam4,
  UINT8 unnamedParam5
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄(圖形內容)。

unnamedParam2

hDepthStencilView [in]

要清除之深度樣板檢視的句柄。

unnamedParam3

樣板 [in]

要設定樣板的不帶正負號 8 位整數值。

unnamedParam4

深度 [in]

要設定深度的單精度浮點數向量。

unnamedParam5

旗標 [in]

值,指定要影響之緩衝區的哪個部分。 此參數必須設定為D3D10_DDI_CLEAR_FLAG列舉的下列其中一個值。

價值 意義
D3D10_DDI_CLEAR_DEPTH (0x01L) 深度值 (Z) 會夾在檢視區的 ZNear 和 ZFar 範圍,該檢視區目前使用 Microsoft Direct3D 系結至位置零。 之後,Z 會再次使用 Direct3D 再次夾住目前系結深度樣板檢視的可表示範圍。
D3D10_DDI_CLEAR_STENCIL (0x02L) 已清除樣板值。

傳回值

沒有

言論

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

浮點規則適用於 clearDepthStencilView 函式

除了D3DDDIERR_DEVICEREMOVED以外,驅動程式不應該發生任何錯誤。 因此,如果驅動程式通過任何錯誤,除了 D3DDDIERR_DEVICEREMOVED 之外,在呼叫 pfnSetErrorCb 函式時,Direct3D 運行時間會判斷錯誤是否重要。 即使移除裝置,驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過,如果裝置移除干擾了 clearDepthStencilView 的作業,驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 桌面
標頭 d3d10umddi.h (包括 D3d10umddi.h)

另請參閱

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb