Platform SDK: DirectX

Direct3DDevice7.SetRenderTarget

Direct3DDevice7.SetRenderTarget メソッドは、レンダリング ターゲットとして新しい DirectDraw サーフェスの方向に、レンダリング出力を簡単に指定することをアプリケーションに許す。

object.SetRenderTarget(surface As DirectDrawSurface7)

パラメータ

object
Direct3DDevice7 オブジェクトを表すオブジェクト式。
surface
既に作成されている、新しいレンダリング ターゲットとなるサーフェス オブジェクトに対する DirectDrawSurface7 オブジェクト。

エラー コード

メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DDERR_INVALIDPARAMS
DDERR_INVALIDSURFACETYPE

トラッピング エラーについては、「Visual Basic エラー トラッピング」を参照すること。

注意

能力は、レンダリング ターゲット サーフェスのプロパティの変化によっては変わらない。Direct3D HAL およびソフトウェア ラスタライザともに、アプリケーションに能力を示す機会は一度だけである。システムは、目的のサーフェスのフォーマットにより異なる能力のセットを提示することはできない。

新しいレンダリング ターゲットに深度バッファがアタッチされている場合、コンテキストの古い z バッファが置き換えられる。それ以外の場合は、古い z バッファのアタッチが解除され、z バッファリングが無効になる。

複数の深度バッファがレンダリング ターゲットにアタッチされていると、この関数は失敗する。

参照

Direct3DDevice7.GetRenderTarget