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

ステンシル [入力]

ステンシルを設定する符号なし 8 ビット整数値。

unnamedParam4

深度 [入力]

深度を に設定する単精度浮動小数点ベクトル。

unnamedParam5

Flags [in]

バッファーのどの部分に影響を与えるかを示す 値。 このパラメーターは、D3D10_DDI_CLEAR_FLAG列挙体の次のいずれかの値に設定する必要があります。

値 意味
D3D10_DDI_CLEAR_DEPTH (0x01L) 深度値 (Z) は、Microsoft Direct3D を使用してスロット 0 に現在バインドされているビューポートの ZNear および ZFar 範囲にクランプされます。 その後、もう一度 Direct3D を使用して、Z は現在バインドされている深度ステンシル ビューの表現可能な範囲に再度クランプされます。
D3D10_DDI_CLEAR_STENCIL (0x02L) ステンシル値がクリアされます。

戻り値

なし

解説

ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。

浮動小数点ルールは ClearDepthStencilView 関数に適用されます。

ドライバーは、D3DDDIERR_DEVICEREMOVEDを除き、エラーが発生しないようにする必要があります。 したがって、ドライバーが pfnSetErrorCb 関数の呼び出しで、D3DDDIERR_DEVICEREMOVEDを除くエラーを渡した場合、Direct3D ランタイムはエラーが重大であると判断します。 デバイスが削除された場合でも、ドライバーはD3DDDIERR_DEVICEREMOVEDを返す必要はありません。ただし、デバイスの削除が ClearDepthStencilView (通常は発生しないはずです) の操作に干渉した場合、ドライバーはD3DDDIERR_DEVICEREMOVEDを返すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb