IDirect3DDevice9::SetDepthStencilSurface メソッド (d3d9.h)

深度ステンシルサーフェスを設定します。

構文

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

パラメーター

[in] pNewZStencil

種類: IDirect3DSurface9*

深度ステンシルサーフェスを表す IDirect3DSurface9 インターフェイスへのポインターのアドレス。 これを NULL に設定すると、深度ステンシル操作が無効になります。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 pZStencilSurface が NULL 以外の場合、ステンシル サーフェスが無効な場合、戻り値はD3DERR_INVALIDCALLされます。

注釈

このメソッドの使用に関する制限事項は次のとおりです。

• マルチサンプルの種類は、レンダー ターゲットと深度ステンシル サーフェスで同じである必要があります。
• この形式は、レンダー ターゲットと深度ステンシル サーフェスに互換性がある必要があります。 「IDirect3D9::CheckDepthStencilMatch」を参照してください。
• 深度ステンシル サーフェスのサイズは、レンダー ターゲットのサイズ以上である必要があります。

これらの制限は、 IDirect3DDevice9Draw メソッドのいずれかが呼び出されたときにデバッグ ランタイムを使用する場合にのみ検証されます。

キューブ テクスチャは、サーフェスのコレクションであるという点で、他のサーフェスとは異なります。 キューブ テクスチャで IDirect3DDevice9::SetDepthStencilSurface を呼び出すには、 IDirect3DCubeTexture9::GetCubeMapSurface を使用して個々の面を選択し、結果のサーフェスを IDirect3DDevice9::SetDepthStencilSurface に渡す必要があります。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	d3d9.h (D3D9.h を含む)
Library	D3D9.lib

こちらもご覧ください

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface