IDirect3DDevice9::SetDepthStencilSurface メソッド (d3d9helper.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 に渡す必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | d3d9helper.h (D3D9.h を含む) |
Library | D3D9.lib |