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

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

構文

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

パラメーター

[in] pNewZStencil

種類: IDirect3DSurface9*

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

戻り値

型: HRESULT

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

注釈

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

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

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

要件

こちらもご覧ください

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface