Platform SDK: DirectX |
Direct3DDevice7.SetRenderTarget メソッドは、レンダリング ターゲットとして新しい DirectDraw サーフェスの方向に、レンダリング出力を簡単に指定することをアプリケーションに許す。
object.SetRenderTarget(surface As DirectDrawSurface7)
メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。
DDERR_INVALIDPARAMS |
DDERR_INVALIDSURFACETYPE |
トラッピング エラーについては、「Visual Basic エラー トラッピング」を参照すること。
能力は、レンダリング ターゲット サーフェスのプロパティの変化によっては変わらない。Direct3D HAL およびソフトウェア ラスタライザともに、アプリケーションに能力を示す機会は一度だけである。システムは、目的のサーフェスのフォーマットにより異なる能力のセットを提示することはできない。
新しいレンダリング ターゲットに深度バッファがアタッチされている場合、コンテキストの古い z バッファが置き換えられる。それ以外の場合は、古い z バッファのアタッチが解除され、z バッファリングが無効になる。
複数の深度バッファがレンダリング ターゲットにアタッチされていると、この関数は失敗する。